Skip to content

Home

Jump to bottom
github-actions[bot] edited this page Aug 7, 2026 · 4 revisions

Note: Canonical documentation lives under docs/. This wiki may lag.

agent-toolkit Wiki

Composable AI capabilities for every major coding assistant — one toolkit, any tool.

agent-toolkit is a modular collection of skills, agent personas, MCP configuration templates, and loop engineering patterns designed to work across all major AI coding assistants. Instead of maintaining separate prompt libraries for each tool, you keep one source of truth and deploy exactly what each tool needs.

What Is Included

Component Count Description
Skills 61 Portable capability definitions across 9 domains
Agent personas 16 Tool-agnostic specialist role definitions
Loop templates 10 Recurring agentic workflows across 3 tiers
Plugins 3 Claude Code and Cursor marketplace bundles
Tool profiles 6 Per-tool configurations (Claude Code, Cursor, OpenCode, Copilot, Windsurf, Pi)
MCP templates 6 Ready-to-use Model Context Protocol configs
Solution packs 3 Curated bundles for common team setups

Navigation

Getting Started

  • Installation — all 4 install methods, prerequisites, verification, updating, uninstalling
  • Profiles — per-tool profile guide for all 6 supported tools

Reference

  • Skills Reference — all 61 skills organized by domain, frontmatter spec, compatibility matrix
  • Agents Reference — all 16 agent personas, triggers, handoffs, invocation patterns
  • Loop Engineering — loop YAML spec, all 10 templates, checkpointing, budget sizing, scheduling
  • MCP Setup — all 6 MCP providers with env vars, setup commands, and per-tool configuration

Marketplace

  • Plugin Marketplace — Claude Code and Cursor plugin installation, plugin structure, building extensions

Contributing

  • Contributing Guide — dev setup, how to add skills, agents, and loops, PR process
  • FAQ — common questions answered

Quick Install

Claude Code Plugin (recommended)

/plugin marketplace add ulises-jeremias/agent-toolkit
/plugin install agent-toolkit-core@agent-toolkit
/plugin install agent-toolkit-agents@agent-toolkit
/plugin install agent-toolkit-forge@agent-toolkit

npx (Agent Skills standard)

# Global install — all compatible tools pick up skills automatically
npx skills add ulises-jeremias/agent-toolkit -g

# Project-scoped install
npx skills add ulises-jeremias/agent-toolkit

Auto-detect script

git clone https://github.com/ulises-jeremias/agent-toolkit.git
bash agent-toolkit/scripts/install.sh

Manual clone

git clone https://github.com/ulises-jeremias/agent-toolkit ~/.agent-toolkit
bash ~/.agent-toolkit/scripts/install.sh

What Can I Do in 5 Minutes?

1. Fix a failing CI run

After installing the Claude Code plugin:

"fix CI"

The gh-fix-ci skill runs automatically: it fetches the failing check logs, identifies the root cause, and proposes a minimal fix — or opens a draft PR if the change is straightforward.

2. Review a PR

"review the current diff"

The code-reviewer agent inspects the diff, checks for quality, security, and correctness issues, and outputs prioritized findings with copy-pasteable fixes.

3. Draft a bug report

"write a bug report for the login redirect issue"

The bug skill generates a structured bug report with reproduction steps, expected vs. actual behavior, and severity classification.

4. Plan a feature

"break down the user profile feature into tasks"

The planning skill decomposes the feature into estimated work items with dependency ordering.

5. Start an OSS maintenance loop

# Initialize the OSS maintenance pack
cp ~/.agent-toolkit/packs/oss-maintenance/config.yaml ~/my-ecosystem.yaml
# Edit to add your repos, then:
agent-toolkit loop run oss-daily-briefing --pack ~/my-ecosystem.yaml

The oss-daily-briefing loop produces a daily read-only briefing across all configured repos — new PRs, issues needing attention, and CI health on main.

Repository Structure

agent-toolkit/
├── skills/         # 61 skills across 9 domains
├── agents/         # 16 agent persona definitions
├── loops/          # 10 loop engineering templates
├── profiles/       # Per-tool configurations (6 tools)
├── mcp/templates/  # 6 MCP provider config stubs
├── plugins/        # 3 marketplace plugin bundles
├── packs/          # 3 solution packs
├── catalogs/       # skill-catalog.yaml, agent-catalog.yaml
├── schemas/        # JSON validation schemas
├── docs/           # Documentation and how-to guides
└── scripts/        # Install and validation scripts

Supported Tools

Tool Plugin npx Manual
Claude Code Yes (recommended) Yes Yes
Cursor Yes Yes Yes
OpenCode No Yes Yes
GitHub Copilot No No Yes
Windsurf No Yes Yes
Pi Coding Agent No Yes Yes

License

MIT — see LICENSE for details.

agent-toolkit

Getting Started

Reference

Compiler

Clone this wiki locally