Agent Almanac

A library of executable skills, specialist agents, and pre-built teams for Claude Code and compatible AI tools. Define repeatable engineering procedures once and have AI agents execute them with built-in validation and error recovery. Compose specialists into review teams that catch issues a single reviewer would miss. Built on the Agent Skills open standard.

At a Glance

• 350 skills across 64 domains — structured, executable procedures
• 71 agents — specialized Claude Code personas covering development, review, compliance, and more
• 16 teams — predefined multi-agent compositions for complex workflows
• 24 guides — human-readable workflow, infrastructure, and reference documentation
• Interactive visualization — force-graph explorer with 350 R-generated skill icons and 9 color themes

How It Works

| Building Block | Location | Purpose | |----------------|----------|---------| | Skills | skills/<skill-name>/SKILL.md | Executable procedures (how) | | Agents | agents/<name>.md | Specialized personas (who) | | Teams | teams/<name>.md | Multi-agent compositions (who works together) | | Guides | guides/<name>.md | Human-readable reference (context) |

Ask Claude Code to review your R package, and the r-package-review team activates 4 agents — each following specialized skills for code quality, architecture, security, and best practices — then synthesizes their findings into a single report.

Works with

Skills follow the Agent Skills open standard and work with any tool that reads markdown:

| Tool | Integration | Details | |------|-------------|---------| | Claude Code | Full (skills, agents, teams) | Plugin install or .claude/ symlinks | | Codex (OpenAI) | Skills | Symlink into .agents/skills/ | | Cursor | Skills | Map to .cursor/rules/*.mdc files | | Gemini CLI, Aider, etc. | Skills | Point context to any SKILL.md file |

Agents and teams use Claude Code's subagent architecture. For other tools, skills are the primary integration surface. See skills/README.md for setup instructions.

Quick Start

60-second path

No setup needed — reference any skill by path in Claude Code:

> "Follow skills/commit-changes/SKILL.md to stage and commit my changes"

Install as Claude Code plugin

# Add a local marketplace pointing to this repo
claude plugin marketplace add /path/to/agent-almanac-marketplace

# Install the plugin
claude plugin install agent-almanac@agent-almanac-local

This auto-discovers all 344 skills and 71 agents. Teams are bundled but require activation via TeamCreate. See Plugin Packaging for marketplace setup details.

Install the CLI

npm install -g agent-almanac

Browse campfires (teams), install skills and agents, and manage content across 12+ frameworks. See cli/README.md for full usage.

Full setup (from source)

Prerequisites: Claude Code CLI installed, Node.js (for README generation and the visualization).

git clone https://github.com/pjt222/agent-almanac.git
cd agent-almanac

Then in Claude Code:

> "Use the code-reviewer agent to review my latest changes"
> "Follow the commit-changes skill to stage and commit"
> "Activate the r-package-review team to review this package"

Make skills available as slash commands

# From the repository root:
ln -s ../../skills/commit-changes .claude/skills/commit-changes
# Then invoke with /commit-changes in Claude Code

See Symlink Architecture for details. All 344 skills are already symlinked in this repository.

Explore visually

cd viz && npm install && npm run dev
# Open http://localhost:5173 for the interactive force-graph explorer

See viz/README.md for full build instructions.

Directory Map

agent-almanac/
  .claude-plugin/  Plugin manifest for Claude Code plugin installation
  skills/          344 executable procedures across 62 domains
  agents/           71 specialist personas
  teams/            16 multi-agent compositions with 8 coordination patterns
  guides/           22 human-readable reference docs
  viz/              Interactive force-graph explorer with R-generated icons
  tests/            30 test scenarios for validation
  i18n/             Translations (4 locales: de, zh-CN, ja, es)
  cli/              Universal installer CLI (npm install -g agent-almanac)
  scripts/          Build and CI automation
  sessions/         Tending session archives

Guides

New here? Start with Understanding the System. See all guides for the full categorized list.

Workflow

• Understanding the System — Entry point: what skills, agents, and teams are, how they compose, and how to invoke them
• Creating Skills — Authoring, evolving, and reviewing skills following the agentskills.io standard
• Creating Agents and Teams — Designing agent personas, composing teams, and choosing coordination patterns
• Running a Code Review — Multi-agent code review using review teams for R packages and web projects
• Managing a Scrum Sprint — Running Scrum sprints with the scrum-team: planning, dailies, review, and retro
• Visualizing Workflows with putior — End-to-end putior workflow visualization from annotation to themed Mermaid diagrams
• Running Tending — AI meta-cognitive tending sessions with the tending team
• Running a Translation Campaign — End-to-end guide for translating all skills, agents, teams, and guides into supported locales using the translation-campaign team
• Unleash the Agents — Structured multi-agent consultation at three tiers for open-ended hypothesis generation
• Team Assembly Prompt Patterns — How to phrase requests to Claude Code for multi-agent team work at every level of specificity
• Production Coordination Patterns — Real-world multi-agent orchestration patterns: barrier synchronization, silence budgets, health checks, degraded-wave policies, and cost-aware scheduling
• AgentSkills Alignment — Standards compliance audits using the agentskills-alignment team for format validation, spec drift detection, and registry integrity
• Edge Computing Deployment — Install agent-almanac skills on edge LLMs (Gemma 4 via AI Edge Gallery) with distilled content, token budgets, and offline bundles
• Self-Continuation Loops Playbook — Choose among ScheduleWakeup, CronCreate loops, and loop.md; select sentinels; plan for the 7-day age-out

Infrastructure

• Setting Up Your Environment — WSL2 setup, shell config, MCP server integration, and Claude Code configuration
• Symlink Architecture — How symlinks enable multi-project discovery of skills, agents, and teams through Claude Code
• R Package Development — Package structure, testing, CRAN submission, pkgdown deployment, and renv management

Reference

• Quick Reference — Command cheat sheet for agents, skills, teams, Git, R, and shell operations
• Agent Best Practices — Design principles, quality assurance, and maintenance guidelines for writing effective agents
• Agent Configuration Schema — YAML frontmatter field definitions, validation rules, and JSON Schema for agent files

Design

• Extracting Project Essence — Multi-perspective framework for extracting skills, agents, and teams from any codebase using the metal skill
• Epigenetics-Inspired Activation Control — Runtime activation profiles controlling which agents, skills, and teams are expressed, grounded in molecular epigenetics
• Understanding the Synoptic Mind — The adaptic concept — panoramic synthesis through simultaneous multi-domain awareness, theoretical foundations, and practical use

Translations

| Locale | Language | Skills | Agents | Teams | Guides | Total | |--------|----------|--------|--------|-------|--------|-------| | de | Deutsch | 322/350 | 3/71 | 1/16 | 3/24 | 329/461 (71.4%) | | zh-CN | 简体中文 | 322/350 | 3/71 | 1/16 | 3/24 | 329/461 (71.4%) | | ja | 日本語 | 322/350 | 3/71 | 1/16 | 3/24 | 329/461 (71.4%) | | es | Español | 322/350 | 3/71 | 1/16 | 3/24 | 329/461 (71.4%) |

See i18n/README.md for the translation contributor guide.

Plugin Packaging

Agent-almanac is packaged as a Claude Code plugin at .claude-plugin/plugin.json. When installed, Claude Code auto-discovers all skills and agents:

| Component | Discovery | Count | |-----------|-----------|-------| | Skills | skills/*/SKILL.md | 344 | | Agents | agents/*.md | 71 | | Teams | Bundled but not auto-discovered | 16 |

Teams are not a plugin-native content type — they require activation via TeamCreate (see Creating Agents and Teams).

To install as a plugin, create a local marketplace wrapper:

# 1. Create marketplace directory
mkdir -p /path/to/marketplace/.claude-plugin

# 2. Create marketplace.json
cat > /path/to/marketplace/.claude-plugin/marketplace.json << 'EOF'
{
  "name": "agent-almanac-local",
  "description": "Local marketplace for agent-almanac",
  "owner": { "name": "Your Name" },
  "plugins": [{
    "name": "agent-almanac",
    "description": "344 skills, 71 agents, 16 teams",
    "source": "./plugins/agent-almanac",
    "category": "development"
  }]
}
EOF

# 3. Symlink the repo into the marketplace
mkdir -p /path/to/marketplace/plugins
ln -s /path/to/agent-almanac /path/to/marketplace/plugins/agent-almanac

# 4. Register and install
claude plugin marketplace add /path/to/marketplace
claude plugin install agent-almanac@agent-almanac-local

Contributing

Contributions welcome! Each content type has its own guide:

• Skills — skills/README.md for format and consumption
• Agents — agents/README.md for template and best practices
• Teams — teams/README.md for coordination patterns
• Guides — guides/README.md for categories and template

Update the relevant _registry.yml when adding content, then run npm run update-readmes.

Support

If Agent Almanac makes your AI tools more capable, consider sponsoring its development.

Reliable AI assistance requires structured knowledge — and maintaining that structure is work that the models themselves cannot do.

License

MIT License. See LICENSE for details.