Agent Playbook

A collection of practical guides, prompts, and skills for AI Agents (Claude Code)

Overview

This repository organizes and stores practical resources for working with AI Agents like Claude Code, including prompt templates, custom skills, usage examples, and best practices.

Installation

Method 0: One-Command Installer (PNPM/NPM)

Sets up skills for Claude Code, Codex, and Gemini, and wires hooks for session logging and self-improvement.

pnpm dlx @codeharbor/agent-playbook init
# or
npm exec -- @codeharbor/agent-playbook init

Project-only setup:

pnpm dlx @codeharbor/agent-playbook init --project

Method 1: Symbolic Links (Recommended)

Link the skills to your global skills directories:

# Create symbolic links for each skill
ln -s /path/to/agent-playbook/skills/* ~/.claude/skills/
ln -s /path/to/agent-playbook/skills/* ~/.codex/skills/
ln -s /path/to/agent-playbook/skills/* ~/.gemini/skills/

Example:

# Link individual skills
ln -s ~/Documents/code/GitHub/agent-playbook/skills/skill-router ~/.claude/skills/skill-router
ln -s ~/Documents/code/GitHub/agent-playbook/skills/architecting-solutions ~/.claude/skills/architecting-solutions
ln -s ~/Documents/code/GitHub/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files

Method 2: Copy Skills

Copy the skills directly to your global skills directories:

cp -r /path/to/agent-playbook/skills/* ~/.claude/skills/
cp -r /path/to/agent-playbook/skills/* ~/.codex/skills/
cp -r /path/to/agent-playbook/skills/* ~/.gemini/skills/

Method 3: Add to Project-Specific Skills

For project-specific usage, create .claude/.codex/.gemini skills directories in your project:

mkdir -p .claude/skills .codex/skills .gemini/skills
cp -r /path/to/agent-playbook/skills/* .claude/skills/
cp -r /path/to/agent-playbook/skills/* .codex/skills/
cp -r /path/to/agent-playbook/skills/* .gemini/skills/

Verify Installation

List your installed skills:

ls -la ~/.claude/skills/
ls -la ~/.codex/skills/
ls -la ~/.gemini/skills/

Skills Manager

Use the local-only skills manager to inspect and manage skills across project and global scopes:

apb skills list --scope both --target all
apb skills add ./skills/my-skill --scope project --target claude

apb is a short alias for agent-playbook.

Project Structure

agent-playbook/
├── prompts/       # Prompt templates and examples
├── skills/        # Custom skills documentation
├── docs/          # Automation best practices and examples
├── mcp-server/    # MCP server for skill discovery
└── README.md      # Project documentation

Skills Catalog

Meta Skills (Workflow & Automation)

Skill	Description	Auto-Trigger
skill-router	Intelligently routes user requests to the most appropriate skill	Manual
create-pr	Creates PRs with automatic bilingual documentation updates	After skill updates
session-logger	Saves conversation history to session log files	Auto (after any skill)
auto-trigger	Defines automatic trigger relationships between skills	Config only
workflow-orchestrator	Coordinates multi-skill workflows and triggers follow-up actions	Auto
self-improving-agent	Universal self-improvement that learns from ALL skill experiences	Background

Core Development

Skill	Description	Auto-Trigger
commit-helper	Git commit messages following Conventional Commits specification	Manual
code-reviewer	Comprehensive code review for quality, security, and best practices	Manual / After implementation
debugger	Systematic debugging and issue resolution	Manual
refactoring-specialist	Code refactoring and technical debt reduction	Manual

Documentation & Testing

Skill	Description	Auto-Trigger
documentation-engineer	Technical documentation and README creation	Manual
api-documenter	OpenAPI/Swagger API documentation	Manual
test-automator	Automated testing framework setup and test creation	Manual
qa-expert	Quality assurance strategy and quality gates	Manual

Architecture & DevOps

Skill	Description	Auto-Trigger
api-designer	REST and GraphQL API architecture design	Manua

...

charon-fan/agent-playbook

README