leapfrog-agent

Bootstrap any project with Leapfrog's org-standard AI development setup — skills, a signal-matching router, and an adoption usage log.

Quick start

npx leapfrog-agent init        # bootstrap (interactive, offline)
npx leapfrog-agent add <skill> # install another bundled skill
npx leapfrog-agent update      # refresh router + preset skills
npx leapfrog-agent status      # health + adoption report
npx leapfrog-agent compress    # caveman-compress prose files (needs API key)

What init creates

• CLAUDE.md — project index (yours to edit)
• .ai/FRAMEWORK.md — skill router + usage-log rules (maintainer-owned)
• .ai/skills/ — installed skills; mirrored to .agents/ and .pi/
• MEMORY.md, .ai/CONTEXT.md, .ai/LEARNINGS.md
• .leapfrog.json — config (committed, no secrets)
• .env.schema — env var reference; put real keys in .env.local (gitignored)

Plugins (skills + MCP + hooks)

Skills are markdown instructions; plugins add hooks and MCP servers too (e.g. caveman, ponytail, claude-mem). Install the curated org set:

npx leapfrog-agent plugins list      # curated + installed
npx leapfrog-agent plugins add <name>
npx leapfrog-agent plugins sync      # all preset plugins
npx leapfrog-agent plugins status    # presence report

On Claude Code, install uses the native plugin system (claude plugin …). On Pi, leapfrog writes the hook + MCP config directly. Every change to a shared config file is shown as a diff and confirmed before writing. Plugin secrets are recorded as env-var names in .env.schema — set real values in .env.local (gitignored).

How skills get used

.ai/FRAMEWORK.md tells the agent to match task signals to a skill, confirm, and log each firing to .ai/usage.log. status reports which skills fire and which never do — so the org standard is driven by data.

Config

.leapfrog.json records your provider/model (by keyEnv name only — never the key), and two skill tiers: preset (refreshed by update) and custom (never touched).

Requirements

Node 20+. macOS/Linux (Windows: skills are copied instead of symlinked).