@codihaus/claude-skills

Claude Code skills for software development workflow.

Quick Start

# Initialize in your project
npx @codihaus/claude-skills init

# That's it! Start Claude Code and try a skill
/debrief "Build a todo app"

What This Does

1. Checks your system - Ensures you have required tools (node, git, etc.)
2. Installs skills - Copies skills to .claude/skills/
3. Configures Claude Code - Sets up permissions and hooks
4. Sets up CLAUDE.md - Creates project instructions file

Available Skills

| Skill | Purpose | |-------|---------| | /debrief | Create BRD and use cases from requirements | | /dev-scout | Explore and document existing codebase | | /dev-arch | Make architecture decisions | | /dev-specs | Create implementation specifications | | /dev-coding | Implement features from specs | | /dev-test | Automated UI testing | | /dev-review | Code review with quality checks | | /dev-changelog | Document what was implemented |

Utility Skills

| Skill | Purpose | |-------|---------| | /utils/diagram | Mermaid diagram validation | | /utils/docs-graph | Documentation relationships | | /utils/gemini | Large codebase scanning (1M context) |

Commands

# Initialize skills in project
npx @codihaus/claude-skills init

# Update to latest version
npx @codihaus/claude-skills update

# Check for updates only
npx @codihaus/claude-skills update --check

# List available skills
npx @codihaus/claude-skills list

# List installed skills only
npx @codihaus/claude-skills list --installed

# Add a specific skill
npx @codihaus/claude-skills add dev-arch

# Remove a skill
npx @codihaus/claude-skills remove dev-arch

# Check system and project setup
npx @codihaus/claude-skills doctor

# Fix issues automatically
npx @codihaus/claude-skills doctor --fix

Init Options

# Skip dependency checking
npx @codihaus/claude-skills init --no-deps

# Skip hooks setup
npx @codihaus/claude-skills init --no-hooks

# Install specific skills only
npx @codihaus/claude-skills init --skills debrief,dev-specs,dev-coding

# Skip confirmation prompts
npx @codihaus/claude-skills init -y

System Requirements

Required

• Node.js 18+
• Git

Recommended

• Python 3.8+ (for /utils/gemini)
• jq (for /utils/docs-graph)

Optional

• GitHub CLI (for PR creation)

Project Dependencies

Some skills work better with project dependencies:

# For UI testing with /dev-test
npm install -D @playwright/test

# For large codebase scanning with /utils/gemini
pip install google-generativeai

Workflow

/debrief "Customer wants..."
    ↓
Creates BRD + Use Cases
    ↓
/dev-arch validates architecture
    ↓
/dev-specs creates implementation plans
    ↓
/dev-coding implements features
    ├── /dev-coding-backend (API work)
    └── /dev-coding-frontend (UI work)
    ↓
/dev-test runs automated tests
    ↓
/dev-review checks code quality
    ↓
/dev-changelog documents what was built

Configuration

Skills are installed to .claude/skills/. You can customize:

• .claude/settings.json - Automation hooks (checked into git for team)
• .claude/settings.local.json - Claude Code permissions (gitignored, personal)
• CLAUDE.md - Project-specific instructions

Updating

# Check for updates
npx @codihaus/claude-skills update --check

# Apply updates
npx @codihaus/claude-skills update

Troubleshooting

# Run doctor to check setup
npx @codihaus/claude-skills doctor

# Fix issues automatically
npx @codihaus/claude-skills doctor --fix

License

MIT