agent-kit

Curated skills, commands, and standards for Claude Code

A collection of battle-tested Agent Skills for Claude Code. Install with a single command and supercharge your AI-assisted development workflow.

Quick Start

# Install the ak CLI
curl -fsSL https://raw.githubusercontent.com/dopsonbr/agent-kit/main/install.sh | bash

# Initialize your project
cd your-project
ak init

The ak binary installs to ~/.local/bin/. Add to your PATH if needed:

export PATH="$HOME/.local/bin:$PATH"

Installation Options

# Install specific version
curl -fsSL https://raw.githubusercontent.com/dopsonbr/agent-kit/main/install.sh | bash -s -- --version v1.0.0

Presets

After installing, initialize your project with a preset:

Preset	Description
standard	Core skills for most projects (default)
full	Everything included
minimal	Just AGENTS.md
claude	Optimized for Claude Code
copilot	Optimized for GitHub Copilot
codex	Optimized for OpenAI Codex CLI
planning	Focus on design and docs
review	Focus on code review
execution	Focus on autonomous execution

# Initialize with a specific preset
ak init --preset claude --yes

What Gets Installed

your-project/
├── .claude/
│   ├── skills/           # Agent Skills
│   │   ├── create-plan/
│   │   ├── plan-execute/
│   │   └── ...
│   ├── commands/         # Slash commands
│   └── settings.json     # Claude configuration
├── CLAUDE.md             # Project instructions for Claude
└── docs/
    ├── plans/            # Implementation plans
    └── adrs/             # Architecture decisions

Available Skills

Planning & Design

Skill	Description
create-plan	Create detailed implementation plans with diagrams
review-plan	Review and validate plans before execution
merge-archive-plan	Archive completed plans with summary

Implementation

Skill	Description
plan-execute	Autonomous plan execution with checkpoints
review-implementation	Review code against plan requirements

Documentation

Skill	Description
doc-contents	Generate CONTENTS.md and AGENTS.md files
create-adr	Create Architecture Decision Records

Skills Development

Skill	Description
skill-creator	Create new Agent Skills with best practices
skill-validator	Validate skills against the specification

Community

Skill	Description
user-request	Request new functionality via GitHub issue
user-contribution	Contribute skills/standards via GitHub PR

Usage

Once installed, use slash commands in Claude Code:

/create-plan       # Plan a new feature
/plan-execute      # Execute a plan autonomously
/review-plan       # Review a plan before implementation
/doc-contents      # Generate project documentation

Or invoke skills directly:

Use the create-plan skill to design a caching layer

Roadmap

✅ Implemented

• Core skills (planning, execution, documentation)
• Slash commands for Claude Code
• CLAUDE.md generation
• Skill validation
• Install script with presets

🚧 In Progress

• user-request skill - Create GitHub issues for feature requests
• user-contribution skill - Create PRs for community contributions
• ak CLI for managing installations

📋 Planned

• Parallel skill execution - Run multiple skills concurrently using best-fit models
• Model routing - Automatically select optimal model per skill (Haiku for quick tasks, Opus for complex reasoning)
• Skill composition - Chain skills together in workflows
• Team presets - Share skill configurations across teams
• MCP server mode - Expose skills as MCP tools
• VS Code extension - GUI for skill management
• Skill marketplace - Discover and install community skills

Project Structure

agent-kit/
├── content/
│   ├── skills/           # Agent Skills (SKILL.md format)
│   │   ├── create-plan/
│   │   ├── plan-execute/
│   │   └── ...
│   └── commands/         # Slash command definitions
├── install.sh            # Installation script
├── docs/
│   ├── plans/            # Implementation plans
│   └── adrs/             # Architecture decisions
└── CLAUDE.md             # Development instructions

Contributing

We encourage contributions! Use the built-in skills to help:

Request a Feature

Use the user-request skill to request [your idea]

This creates a well-formatted GitHub issue with your request.

Contribute a Skill

Use the user-contribution skill to contribute [your skill/enhancement]

This guides you through creating a PR with proper formatting.

Manual Contribution

1. Fork and clone the repo
2. Create your skill in content/skills/your-skill/
3. Use /skill-validator to validate
4. Submit a PR

See CLAUDE.md for development instructions.

Skill Format

Skills follow the Agent Skills specification:

---
name: skill-name
description: What it does and when to use it
---

# Skill Instructions

Your detailed instructions here...

License

MIT © agent-kit contributors

---

Built with Agent Skills