Agents

This repository contains local agent definitions under agents/, local skills
under skills/, and instructions under instructions/.

Instructions

# Claude:
ln -sf $PWD/instructions/CLAUDE.md ~/.claude/CLAUDE.md

# VSCode Copilot:
ln -sf $PWD/instructions/copilot-instructions.md ~/.copilot/copilot-instructions.md

# Cursor:
mkdir -p ~/.cursor/rules
ln -sf $PWD/instructions/cursor-instructions.mdc ~/.cursor/rules/agents.mdc

Local Agents

Current local agents:

• architecture
• code-qa-engineer
• code-reviewer
• devops-engineer
• performance-engineer
• principal-engineer
• researcher-engineer
• security-engineer
• ux-engineer

Note: Keep this list in sync with the agents/ directory or generate it from the filesystem.

Link all local agents into ~/.claude/agents:

mkdir -p ~/.claude/agents
for f in agents/*.agent.md; do
  ln -sf "$PWD/$f" "$HOME/.claude/agents/$(basename "$f")"
done

Local Skills

Current local skills:

• change-review: Provides a structured code review of a proposed change, including feedback on correctness, style, maintainability, and potential impacts.
• github-actions: Provides best practices and guidance for GitHub Actions workflow design, review, and troubleshooting. Use when you need correct, secure, and maintainable CI/CD workflow recommendations.
• openai-reusable-prompts: Designs and improves prompt best practices and formatting structure for OpenAI use cases. Use when you need clear, consistent prompt templates, stronger instruction writing, and better formatted prompt sections.
• poc: Produces a focused proof-of-concept plan, feasibility assessment, and minimal experiment artifacts for a feature, integration, or architectural approach.
• refactor: Refactor code to improve its structure, readability, and maintainability without changing its external behavior.
• review: Review or analyze something, such as a document, code, or data, to provide feedback, identify issues, or suggest improvements.
• rewrite: Performs a structured, opinionated, and safety-conscious full rewrite that intentionally introduces breaking changes.

Install all local skills:

for d in skills/*/; do
  npx skills add "./${d%/}" --global --symlink -y
done

Optional External Skills

for skill in \
  mattpocock/skills/caveman \
  mattpocock/skills/grill-me \
  mattpocock/skills/improve-codebase-architecture \
  mattpocock/skills/to-issues \
  mattpocock/skills/to-prd \
  mattpocock/skills/tdd \
  mattpocock/skills/ubiquitous-language \
  vercel-labs/agent-skills/skills/web-design-guidelines
do
  npx skills add "$skill" --global --symlink -y
done

• caveman: Enable compressed, token-efficient assistant responses.
• grill-me: Deeply interview the user to stress-test a plan or design.
• improve-codebase-architecture: Identify architecture improvements for testability and AI navigation.
• to-issues: Break a PRD into independent implementation issues.
• to-prd: Break a high-level goal into a structured PRD with features, user stories, and acceptance criteria.
• tdd: Apply red-green-refactor workflows.
• ubiquitous-language: Establish a common language across the team to improve communication and understanding.
• web-design-guidelines: Follow best practices for web design and user experience.

MCP

• @sveltejs/mcp