Skip to Content
IntegrationsClaude CodeAgents & Skills

Agents & Skills

This is the deep dive into Agents and Skills. For basic setup, see Claude Code Integration.

Agents

The .claude/agents/ directory contains agent definitions that Claude Code loads automatically. These aren’t generic instructions — they’re specialized roles designed around the SpecForge workflow:

  • Planning agents guide you through specification refinement, asking the right questions about goals, constraints, edge cases, and acceptance criteria
  • Implementation agents know how to pick up tickets, follow implementation steps, report progress, and complete work sessions
  • Validation agents check completed work against acceptance criteria and report findings

Skills

The .claude/skills/ directory contains operational skills — step-by-step protocols for using SpecForge MCP tools correctly. Skills encode the workflow so Claude Code doesn’t need to figure out tool sequencing from scratch:

  • How to start a planning session and iterate through decomposition
  • How to claim a ticket, implement it, and close the work session
  • How to run reviews and address findings
  • How to handle blocks and discoveries during implementation
Agent TeamsClaude Desktop