claude-skills

Agent Skills (prev. Claude Skills)

Collection of Agent skills, MCP servers, and hooks for enhanced productivity.

Components

MCP Servers

Server	Description	Status
mcp-github-issues	Fetch GitHub issues and PRs	✅ Ready
mcp-debug-cycle	Automated debug instrumentation	✅ Ready

Skills

Skill	Description	Status
code-review	Automated code review against CLAUDE.md	✅ Ready
clone-react-skill	Clone any component with interactive selector	✅ Ready
housekeeping-skill	Clean up .claude folders and optimise files	✅ Ready

Hooks

Hook	Description	Status
cost-monitor	Track token usage, warn at limits	✅ Ready
notify-complete	OS notification on task completion	✅ Ready
tdd-enforcement	Block non-test edits in TDD mode	✅ Ready

Quick Start

# Clone and build
git clone https://github.com/jkneen/claude-skills.git
cd claude-skills
pnpm install
pnpm build

Install MCP Servers

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "github-issues": {
      "command": "node",
      "args": ["/path/to/claude-skills/packages/mcp-github-issues/dist/index.js"]
    },
    "debug-cycle": {
      "command": "node",
      "args": ["/path/to/claude-skills/packages/mcp-debug-cycle/dist/index.js"]
    }
  }
}

Install Skill

cp -r skills/code-review ~/.claude/skills/

Install Hooks

Add to ~/.claude/hooks.json:

{
  "hooks": [
    {
      "matcher": "PostToolUse",
      "hooks": [{ "type": "command", "command": "node /path/to/hooks/cost-monitor/cost-monitor.js" }]
    },
    {
      "matcher": "Stop",
      "hooks": [{ "type": "command", "command": "node /path/to/hooks/notify-complete/notify.js" }]
    },
    {
      "matcher": "PreToolUse",
      "hooks": [{ "type": "command", "command": "node /path/to/hooks/tdd-enforcement/tdd-guard.js" }]
    }
  ]
}

MCP Server Details

GitHub Issues MCP

Tools:

• github_get_issue - Fetch issue by number with comments
• github_list_issues - List/filter issues
• github_get_pr - Fetch PR with diff summary
• github_search_issues - Full-text search

Debug Cycle MCP

Tools:

• debug_add_logs - Add instrumentation to files
• debug_remove_logs - Clean up debug logs
• debug_capture_output - Run command, capture output
• debug_analyze_output - Analyze captured logs

Hook Details

Cost Monitor

Tracks tokens per tool call, warns at 80% of daily limit. Logs to ~/.claude/usage.json.

Notify Complete

OS notification (macOS/Linux/Windows) when Claude completes a task.

TDD Enforcement

When ~/.claude/tdd-mode exists, blocks edits to non-test files. Forces test-first discipline.

Development

pnpm install     # Install dependencies
pnpm build       # Build all packages
pnpm typecheck   # Type check

Roadmap

P2 - Planned

• Jira/Linear Integration
• CLAUDE.md Auto-Learning

P3 - Future

• Context Management MCP
• Parallel Task Orchestration

License

MIT