Agents — AI Context Library
Reusable Claude Code components: skills, agents, commands, rules, plugins, MCP server configurations, and a universal component management system.
Quick Start
just init # Install deps, init knowledge graph, pull embedding model
just agents --help # CLI tool for component management
Architecture
content/ Component source of truth
├── skills/ SKILL.md files (130+)
├── agents/ Agent definitions (markdown + frontmatter)
├── commands/ Slash commands (markdown + frontmatter)
├── rules/ Instruction rules (markdown)
├── plugins/ Plugin bundles (.claude-plugin/plugin.json)
├── hooks/ Hook configurations
├── output-styles/ Output formatting templates
└── reference/ Reference documentation
packages/cli/ TypeScript tooling (Bun + Citty)
├── src/
│ ├── bin/agents.ts CLI entrypoint
│ ├── commands/ Command modules (verb-first + legacy noun-first)
│ ├── lib/ Library modules
│ │ ├── component/ Universal component model (7 providers)
│ │ ├── skill-*.ts Skill lifecycle (add/find/list/outdated/update/remove/info/init)
│ │ └── ... Hash, lockfile, output, runtime, schemas, etc.
│ ├── client/ Graph viewer frontend
│ ├── server/ Graph viewer backend
│ └── sql/ SQL query files
└── test/ bun:test suites (900+ tests)
settings/mcp/ MCP server configurations
docs/src/adr/ Architecture Decision Records
CLI Commands
Skill Management
just agents skill add owner/repo@skill # Install a skill
just agents skill find "kubernetes" # Search registries
just agents skill list # List installed skills
just agents skill list --agent claude-code # Filter by agent
just agents skill outdated # Check for updates
just agents skill update # Update outdated skills
just agents skill remove skill-name # Remove a skill
just agents skill info skill-name # Detailed metadata
just agents skill init my-skill # Scaffold new skill
MCP Server Management
just agents mcp search "postgres" # Search Smithery registry
just agents mcp add smithery://ns/server --client cursor # Add to client config
just agents mcp list --client claude-desktop # List in client config
just agents mcp remove server-name --client cursor # Remove from client
just agents mcp info ns/server-name # Server details
just agents mcp publish --name ns/server --url https://...# Publish to Smithery
Cross-Type Component Search
just agents component search "kubernetes" # Search all types
just agents component list # List all installed
just agents component list --type agent # Filter by type
Other Commands
just agents plugin check <name> # Validate a plugin
just agents skill validate <name> # Validate skill frontmatter
just kg-search "query" # Semantic search (knowledge graph)
Component Model
All entity types flow through a universal ComponentProvider interface:
| Provider | ID | Entity Types | Backend |
|---|
| LocalProvider | local | skill | Filesystem (wraps skill-* modules) |
| LocalAgentProvider | local-agent | agent | content/agents/**/*.md |
| LocalPluginProvider | local-plugin | plugin | content/plugins/**/.claude-plugin/ |
| LocalRuleProvider | local-rule | rule | content/rules/**/*.md |
| LocalCommandProvider | local-command | command | content/commands/**/*.md |
| LocalOutputStyleProvider | local-output-style | output-style | content/output-styles/**/*.md |
| SmitheryProvider | smithery | mcp-server | registry.smithery.ai API |
The ComponentManager aggregates search across all providers, deduplicates results, and handles pagination.
AI Client Config Support
MCP servers can be installed to 19 AI client config files:
| Client | Method | Format |
|---|
| Claude Desktop | file | JSON |
| Claude Code | command | claude mcp add |
| Cursor | file | JSON |
| Windsurf | file | JSON |
| VS Code | command | code --add-mcp |
| Cline, Roo Code, Continue, Zed, Goose, OpenCode, ... | file | JSON/YAML/JSONC |
Plugin Marketplace
Curated plugins at .claude-plugin/marketplace.json:
| Plugin | Description |
|---|
homebrew-dev | Homebrew formula development |
browser-extension-dev | Cross-browser extension development |
blog-workflow | Technical blog post creation |
job-hunting | Job hunting toolkit |
swiftui-dev | SwiftUI development |
design-to-code | Design-to-code conversion |
Dependencies
