Benchdive

A directory of Skydive agents, seeded from real use cases and growing with community contributions. An agent is one file in this repo: YAML frontmatter with the setup, a Markdown prompt with the job. Browse the directory at benchdive.com, add an agent to Skydive with one click where a template exists, or copy its setup prompt and run it yourself.

Not affiliated with Skydive.

How it works

Every agent is a single agents/<slug>.md file. There is no database and no admin UI — the repo is the source of truth, and the site is a static build over it. Each agent can be run two ways:

1. Add to Skydive — when the agent has a template_url, the card links straight to a pre-built Skydive template; one click and it's live.
2. Copy the setup prompt — always available. Copy the Markdown body and paste it into Skydive (or any compatible agent runtime) as the first message to configure the agent from scratch.

Each listing carries a provenance badge derived from its data, not a separate field:

Badge	Meaning	Derived from
Official template	Ready-made, one-click	has template_url
Adapted from use case	Scouted from a public source and adapted	has scouted_by
Community	Contributed directly	neither of the above

Agents are organized into 13 categories: Engineering, Product, Design, Support, Sales, Marketing, Data, Recruiting, Operations, Finance, Legal, Founders, Personal.

Quickstart

pnpm install
pnpm dev        # dev server at http://localhost:4321

Other scripts:

Script	What it does
pnpm dev	Local dev server
pnpm build	Production build to dist/
pnpm preview	Serve the production build locally
pnpm check	Astro + TypeScript type checking
pnpm validate	Schema, slug, and duplicate checks over agents/*.md
pnpm icons	Fetch missing integration icons

Uses pnpm. CI runs validate, check, and build on every pull request.

Contributing an agent

Adding an agent is one Markdown file and a pull request:

1. Create agents/<slug>.md where <slug> is the slugified name (e.g. name: "Cash Forecaster" → agents/cash-forecaster.md).
2. Fill in the frontmatter and the prompt body.
3. Run the checks locally: pnpm validate && pnpm check && pnpm build.
4. Open a pull request.

See CONTRIBUTING.md for the full frontmatter contract, the slug rule, the quality bar, and a complete example. Minimal shape:

---
name: Cash Forecaster
role: Cash Forecaster
purpose: "Weekly cash forecast, names the tight week early."
category: Finance
added_at: "2026-08-21T14:00:00.000Z"
integrations: [QuickBooks, Stripe, Slack]
skills: [cash-flow-modeling, variance-flagging]
---

Set up a new agent named Cash Forecaster to … then save it and run weekly.

Every submission is checked for format (passes pnpm validate), attribution (scouted_by / contributor credit any adapted source), and safety (the prompt asks for reasonable, non-destructive work). Listings are a starting point you copy and adapt — we don't test them against a live workspace or guarantee performance.

Public API

The whole directory is available as JSON — no auth, no key, cached at the edge (~60s).

Endpoint	Returns
/api/agents.json	Every agent, newest first
/api/agents/<category>.json	One category (e.g. /api/agents/engineering.json)
/api/	Human-readable API docs

Response shape:

{
  "version": 1,
  "meta": {
    "total": 230,
    "categories": { "Engineering": 29, "Sales": 21, "…": 0 },
    "buildAt": "2026-08-22T17:56:43.563Z",
    "newestAddedAt": "2026-08-22T12:00:00.000Z",
    "docsUrl": "https://benchdive.com/api/"
  },
  "agents": [
    {
      "slug": "cash-forecaster",
      "name": "Cash Forecaster",
      "role": "Cash Forecaster",
      "purpose": "Weekly cash forecast, names the tight week early.",
      "category": "Finance",
      "addedAt": "2026-08-21T14:00:00.000Z",
      "integrations": ["QuickBooks", "Stripe", "Slack"],
      "integrationUrls": {},
      "skills": ["cash-flow-modeling", "variance-flagging"],
      "status": "adapted",            // official | adapted | community
      "prompt": "Set up a new agent named …",
      "templateUrl": null,
      "contributor": "dhruvamin",
      "contributorUrl": "https://x.com/dhruvamin",
      "scoutedBy": "231 ways to use an agent",
      "scoutedByUrl": "https://…",
      "addedVia": null,
      "url": null,
      "detailUrl": "https://benchdive.com/agents/cash-forecaster/"
    }
  ]
}

The repo is the only write path — there is no write API.

Repo layout

agents/                 # one .md per agent (the data)
src/
  content.config.ts     # Zod schema for agent frontmatter
  lib/constants.ts      # categories, slugify, provenance status
  pages/                # index, agents/[slug], sponsor, api/*
  components/           # AgentCard, AgentRow, etc.
scripts/
  validate-agents.ts    # pnpm validate
  fetch-icons.ts        # pnpm icons
CONTRIBUTING.md

Stack

Astro (static output) · Tailwind CSS · TypeScript · Zod content collections. Content lives in Git; the site is a static build served from the edge.

License

MIT © César Ramírez