# Deftro

> Deftro is a hosted registry for AI-agent skills and prompts. An organisation keeps the skills and prompts its engineers write for coding agents such as Claude Code, Cursor, Codex and Antigravity, scopes them to projects, reviews each version before anyone runs it, and installs it into whatever agent each engineer uses.

Competitors built distribution: catalogs, install commands, star counts. The complaint in the market is trust. Deftro is the review gate: a diff against the last approved version, a named reviewer, a decision recorded in an append-only Activity trail. Approved versions are immutable, enforced by a database trigger. Deftro does not claim a skill is harmless; the health check flags careless cases (leaked keys, obvious prompt-injection phrases, hidden text) and nothing more.

Definitions:
- Agent skill: a folder with a SKILL.md file (a name, a description and Markdown instructions, sometimes scripts beside it) that a coding agent loads when a task matches it.
- Prompt: reusable text for a chatbot or agent, optionally with blanks to fill in.
- Artifact: a skill or a prompt, with its published versions.
- Review: an admin or project lead reads the diff and health check notes for a new version, then approves it or requests changes.

## Public pages

- https://baton-vault.vercel.app/ : product overview and FAQ
- https://baton-vault.vercel.app/about : the problem and the thesis
- https://baton-vault.vercel.app/pricing : Personal and Team are free (Team up to ten members); Company is paid
- https://baton-vault.vercel.app/skills : the most-installed public agent skills
- https://baton-vault.vercel.app/prompts : the most-installed public AI prompts
- https://baton-vault.vercel.app/discover : every public skill and prompt, newest first, filterable by tag
- https://baton-vault.vercel.app/search?q= : search the public catalogue
- https://baton-vault.vercel.app/p/{handle}/{slug} : one public artifact, with its install command and every published version
- https://baton-vault.vercel.app/{handle} : an author's or organisation's profile and their public artifacts
- https://baton-vault.vercel.app/topics : every tag with its public skill and prompt counts
- https://baton-vault.vercel.app/topics/{tag} : public skills and prompts that share one tag
- https://baton-vault.vercel.app/leaderboard : public artifacts ranked by how many people kept them installed for 30 days
- https://baton-vault.vercel.app/leaderboard?tab=trending : the skills and prompts starred most in the last 7 days
- https://baton-vault.vercel.app/leaderboard?tab=authors : authors ranked by installs in the last 30 days
- https://baton-vault.vercel.app/feedback : the public Feedback board: feature requests and problem reports about the product, with votes and status (open, planned, in progress, shipped)
- https://baton-vault.vercel.app/feedback/{id} : one request on the board: what was asked, its status history, votes and comments
- https://baton-vault.vercel.app/community : the community forum: questions and show-and-tell about agent skills and prompts, with votes and moderation
- https://baton-vault.vercel.app/community?category={slug} : the threads in one community category
- https://baton-vault.vercel.app/community/t/{id}/{slug} : one community thread: the post, its votes and its threaded replies
- https://baton-vault.vercel.app/help : the help center: short articles on every signed-in area and what each refusal means
- https://baton-vault.vercel.app/extension : the browser extension that inserts saved prompts into chatbots
- https://baton-vault.vercel.app/legal/sponsor-terms : the terms for bidding on and running Sponsored placements
- https://baton-vault.vercel.app/legal/ad-policy : what may and may not be advertised in a Sponsored placement
- https://baton-vault.vercel.app/legal/cookies : every cookie and browser storage key, and the analytics opt-out
- https://baton-vault.vercel.app/legal/grievance : the Grievance Officer, how to complain, and response times
- https://baton-vault.vercel.app/legal/subprocessors : the companies that process personal data for Deftro
- https://baton-vault.vercel.app/legal/copyright : copyright takedown and counter-notice process
- https://baton-vault.vercel.app/privacy, https://baton-vault.vercel.app/terms, https://baton-vault.vercel.app/extension/privacy

## Guides

- https://baton-vault.vercel.app/guides : every guide
- https://baton-vault.vercel.app/guides/what-are-agent-skills : What an agent skill is, what goes in a SKILL.md, and how Claude Code, Cursor, Codex and Antigravity load them. With examples you can install.
- https://baton-vault.vercel.app/guides/install-claude-code-skills : Where Claude Code looks for skills, how to install one with a single command, and how to keep a team on the same reviewed version.
- https://baton-vault.vercel.app/guides/cursor-rules : How .cursor/rules and .mdc files work, how they differ from the old .cursorrules and AGENTS.md, and how to share one set of rules across a team.
- https://baton-vault.vercel.app/guides/skills-vs-mcp : Skills are instructions an agent reads; MCP servers are tools it calls. When to use each, and how they work together in Claude Code and Cursor.
- https://baton-vault.vercel.app/guides/review-agent-skills : A skill runs with your agent's access. What can go wrong, what to read before installing one, and how a team reviews each version first.
- https://baton-vault.vercel.app/guides/save-prompts-chatgpt : Keep the prompts that work in one library and insert them into ChatGPT, Claude or Gemini by typing // and a short name. Blanks filled for you.

## Clients

- https://baton-vault.vercel.app/get-started.md : setup guide for a coding agent (Claude Code, Cursor, Codex): add the MCP server, sign in through the browser, install the deftro skill
- CLI: `npx @deftro/cli` (command `deftro`): install, sync, login, publish. Writes Claude Code (.claude/skills), Cursor (.cursor/rules) and Antigravity (.agents/skills) formats.
- MCP server: `npx @deftro/mcp`: search, install, publish and sync from inside any MCP client.
- Browser extension: inserts saved prompts into ChatGPT, Claude, Gemini and Grok with a `//alias`. Nothing is sent until you press send.
- HTTP API: https://baton-vault.vercel.app/api/v1 (bearer token or session).
- Agent brief for coding agents: GET /api/v1/agent-brief (authenticated).

## Vocabulary

Review (not approval workflow), Activity (not audit log), Health check (not security scan), Project settings, Artifact (a skill or a prompt).