# ~/.config/claude/ Inventory for Migration

**Date:** 2025-11-28
**Context:** Evaluating personal Claude Code customizations for migration to outfitter-dev/agents

## Summary

| Type | Count | Notable |
|------|-------|---------|
| Skills | 23 | Meta-tools, workflows, GitButler, Linear integration |
| Agents | 21 | Specialist experts (security, TDD, architecture, etc.) |
| Commands | 27 | Organized by workflow (review, sitrep, issues) |

---

## Skills Inventory

### Agent & Skill Authoring (5 skills)

- **subagent-authoring** (291 lines) - Creates/updates agents with YAML frontmatter
- **agent-skill-authoring** (292 lines) - Creates/updates skills with progressive disclosure
- **agent-skill-validation** (375 lines) - Validates against best practices, YAML schema
- **agent-skill-review** (505 lines) - Reviews for discoverability, clarity, conciseness
- **agent-validation** (305 lines) - Validates agents against best practices

### Development & Workflow (6 skills)

- **brainstorming** (146 lines) - Adaptive Q&A with confidence tracking → **REPLACED BY JAM**
- **scenario-testing** (305 lines) - E2E testing instead of unit tests
- **find-skills** (285 lines) - Skill discovery across sources → **MIGRATE AS discover-skills**
- **agent-skill-list-flags** - Lists skill flags with grouping
- **find-waymarks** - Code annotation search (:::) → **MIGRATE AS waymark PLUGIN**
- **config-coderabbit** (257 lines) - CodeRabbit YAML config

### Version Control & Git (5 skills) → **MIGRATE AS gitbutler PLUGIN**

- **gitbutler-version-control** (483 lines) - Virtual branches for parallel work
- **gitbutler-stack-workflows** (509 lines) - Stack creation and reorganization
- **gitbutler-complete-branch** (620 lines) - Branch completion with safety checks
- **gitbutler-multi-agent** (420 lines) - Multi-agent collaboration via virtual branches

### Pairing & Collaboration (3 skills)

- **codex-pairing** - OpenAI Codex CLI pair programming
- **oracle-pairing** - Oracle CLI collaboration
- **repoprompt-pairing** - RepoPrompt MCP orchestration

### Project Integration (3 skills)

- **implement-linear-issue** (488 lines) - End-to-end Linear issue workflow
- **implement-pr-feedback** (529 lines) - PR feedback across Graphite stacks
- **sitrep** - Multi-source 'check-status' reports (Graphite, GitHub, Linear)

---

## Agents Inventory

### Tier 1: Universal, High Value (11 agents)

| Agent | Purpose | Dependencies |
|-------|---------|--------------|
| **code-reviewer** | Tiered feedback (critical→minor) | Superpowers plugin |
| **systematic-debugger** | Evidence-based root cause analysis | Superpowers plugin |
| **test-driven-developer** | TDD red-green-refactor | Bun/Cargo test tools |
| **type-safety-enforcer** | Strict TS, eliminate `any`, Ultracite | TypeScript 5.7+ |
| **security-auditor** | Threat modeling, OWASP/CWE | Security expertise |
| **performance-optimizer** | Profiling, benchmarking, bottlenecks | Profiling tools |
| **senior-engineer** | Production code, features, refactoring | Language knowledge |
| **systems-architect** | Design, tech selection, scaling | firecrawl |
| **research-engineer** | Evidence-based recommendations | firecrawl, context7 |
| **docs-librarian** | Documentation discovery, 70-85% compression | context7, firecrawl |
| **safe-commit-specialist** | Atomic commits, quality gates | Git, local tools |

### Tier 2: Niche but Valuable (6 agents)

| Agent | Purpose | Dependencies |
|-------|---------|--------------|
| **complexity-challenger** | Anti-overengineering | Superpowers |
| **bun-expert** | Bun migrations, monorepos, perf | context7 |
| **cicd-optimization-expert** | GitHub Actions optimization | GitHub Actions |
| **pr-review-implementer** | PR feedback across Graphite stacks | Graphite, gh |
| **vercel-ai-sdk-expert** | AI SDK v5 streaming, agents | context7, firecrawl |
| **status-scout** | Read-only repo SITREP | gh, Graphite |

### Tier 3: Specialized (2 agents)

| Agent | Purpose | Dependencies |
|-------|---------|--------------|
| **claude-code-expert** | Claude Code CLI/SDK/ecosystem | Research tools |
| **gitbutler-ops** | GitButler virtual branches | GitButler CLI |

### Not Ready

- **test** - empty placeholder (delete)

---

## Migration Decisions

### Confirmed for Migration

1. **discover-skills** → `outfitter` plugin
   - Rename from find-skills
   - Skill discovery across user, project, plugin sources

2. **gitbutler** → New plugin
   - gitbutler-version-control
   - gitbutler-stack-workflows
   - gitbutler-complete-branch
   - gitbutler-multi-agent
   - gitbutler-ops agent

3. **waymark** → New plugin
   - find-waymarks skill

### Under Consideration

- **Agents** - Most are portable but have dependencies (Superpowers, MCP servers)
- **Linear integration** - Could be own plugin or fold into outfitter
- **Authoring/validation skills** - Could enhance claude-dev

---

## Commands Structure (for reference)

```
~/.config/claude/commands/
├── review/           # 9 commands (code, perf, sec, deps, pr-single, etc.)
├── sitrep/           # 4 commands (scout, stack, pr, issues)
├── issues/           # work-on-issue
├── recap/            # create, review
├── init/             # use-core, use-repoprompt
├── subagent/         # orchestrate, pair-program
└── (root)            # skills, docs/get, ask, create-gist, test
```

---

## Dependencies to Note

- **Superpowers plugin** - code-reviewer, systematic-debugger, complexity-challenger delegate to superpowers:* skills
- **MCP servers** - docs-librarian, research-engineer, bun-expert rely on context7/firecrawl
- **Graphite** - pr-review-implementer, status-scout, sitrep use Graphite stacks
- **GitButler** - gitbutler-* skills and gitbutler-ops agent

---

## Next Steps

1. Create `gitbutler` plugin with 4 skills + agent
2. Create `waymark` plugin with find-waymarks skill
3. Add `discover-skills` to outfitter plugin
4. Evaluate agent migration after skills are stable