# Prave

> The platform that lets your AI agent manage its own Claude Skills.
> Prave indexes ~20,000 Skills and Hooks; instead of hand-managing your
> ~/.claude/skills/ folder, you wire the Prave MCP into Claude Code and
> Claude Desktop once and the agent searches per task, installs only
> what a task needs, watches its context footprint, tidies unused
> Skills, and syncs updates — sparingly, in the background. The Prave
> MCP is a Max feature ($10/mo); on the Free plan you browse the
> catalogue and install Skills by hand.

Prave is a registry + MCP + CLI + dashboard for agent "Skills" —
reusable Markdown files (`SKILL.md`) with frontmatter that AI coding
agents auto-load into context. Built around Anthropic's SKILL.md spec
for Claude Code, Prave also supports Codex, Cursor, Gemini CLI, Cline,
and Amp as managed install targets.

The catalogue holds ~20,000 public Skills sourced from curated GitHub
repositories and a daily scan of public GitHub for permissively-licensed
`SKILL.md` files (MIT, Apache-2.0, BSD-2/3-Clause, ISC, MPL-2.0,
Unlicense, CC0-1.0, 0BSD). Copyleft and proprietary repos are rejected.

## How management works (MCP-first)

Management via the Prave MCP is a **Max** feature; the Free plan is
manual install only.

1. **Opt in (Max)** — on Max, a nudge at CLI install asks "Let Claude
   manage your skills for you?", or run `prave mcp install`. Both are
   opt-in and reversible (`prave mcp uninstall`).
2. **What it wires** — registers the Prave MCP for Claude Code + Desktop
   and appends a short, delimited managed block to the global
   `~/.claude/CLAUDE.md`.
3. **The sparingness policy** — the block tells the agent to install
   only the single best match a task needs, respect a ~200,000-token
   context budget (checking headroom before installing), avoid
   speculative preloading, tidy Skills unused for 30+ days every ~15–30
   days, and keep installed Skills updated. Sparing by design so it
   never floods a session.
4. **The tool surface** — `prave_search_skills`, `prave_search_hooks`,
   `prave_whatdoes`, `prave_install_skill`, `prave_install_hook`,
   `prave_uninstall_skill`, `prave_uninstall_hook`,
   `prave_library_status` (footprint + headroom), `prave_tidy`,
   `prave_check_updates`, `prave_sync`.

## Docs

- [Getting started](https://prave.app/docs/getting-started): Install,
  opt in, let Claude take over.
- [Let Claude manage your skills](https://prave.app/docs/managed): The
  concept, the sparingness policy, the CLAUDE.md block.
- [MCP reference](https://prave.app/docs/cli/mcp): Setup + the full
  tool surface for Claude Code + Desktop.
- [Concepts](https://prave.app/docs/concepts): Skills, Hooks, the
  managed library, the context budget.
- [Pricing](https://prave.app/docs/pricing): Free ($0) and Max
  ($10/mo · $75/yr). See also
  [/pricing.md](https://prave.app/pricing.md) for machine-readable data.
- [CLI reference](https://prave.app/docs/cli/cheat-sheet): Every
  `prave` command in one page.

## Web app

- [Discover](https://prave.app/discover): The public catalogue,
  filterable by category, license, popularity.
- [Skill Intelligence](https://prave.app/dashboard/intelligence):
  Token-cost audit, conflict detector, 30-day trigger telemetry.
- [Dashboard](https://prave.app/dashboard): Watch what the agent
  installed, tidied, and synced; MCP connection status.

## Supported agents

| Agent | Format | Status |
|---|---|---|
| Claude Code | `SKILL.md` (canonical) | Manual install on Free; managed MCP + live trigger telemetry + sync on Max. |
| Claude Desktop | via MCP | Managed via the Prave MCP (Max). |
| OpenAI Codex CLI | `SKILL.md` | Managed install target (Max). |
| Cursor | `.cursor/rules/<slug>.mdc` | Managed install target with frontmatter conversion (Max). |
| Gemini CLI | `SKILL.md` | Managed install target (Max). |
| Cline | `SKILL.md` | Managed install target (Max). |
| Amp | `SKILL.md` | Managed install target (Max). |

## Legal + privacy

- [Privacy Policy](https://prave.app/legal/privacy) — full processor
  table, GDPR-compliant. EU-hosted on Hetzner, database in Supabase
  Frankfurt, 100% renewable energy.
- [Terms](https://prave.app/legal/terms)
- [Imprint](https://prave.app/legal/imprint) — German legal
  imprint (Impressum). Operating entity: EppLab Studio.

## Contact

- Email: hello@epplab-studio.de
- Issues: https://github.com/eppstudio/prave/issues
- npm: https://www.npmjs.com/package/@prave/cli