Project Commands Skill

This skill helps agents find and use the correct commands for the current project.

Finding Commands

All project-specific commands are defined in .claude/commands.md. Always read this file before running commands.

# Read the commands file
cat .claude/commands.md

Command Categories

Development

• •Install: Set up project dependencies
• •Dev: Start development server
• •Build: Create production build

Testing

• •Test: Run all tests
• •Test:unit: Unit tests only
• •Test:e2e: End-to-end tests (Playwright)
• •Test:coverage: Tests with coverage report

Code Quality

• •Lint: Check code style
• •Format: Auto-format code
• •Typecheck: Verify types

Setting Up Commands for a New Project

1. •Copy the template:

cp .claude/commands.template.md [target-project]/.claude/commands.md

1. •Replace placeholders with actual commands:

{{install}} → npm install (or yarn, pnpm, etc.)
{{dev}} → npm run dev
{{dev_url}} → http://localhost:3000
{{test}} → npm test

1. •Remove unused sections (database, docker, etc.)

Common Patterns by Stack

Node.js / npm

{{install}}: npm install
{{dev}}: npm run dev
{{test}}: npm test
{{build}}: npm run build

Python / pip

{{install}}: pip install -r requirements.txt
{{dev}}: python manage.py runserver
{{test}}: pytest
{{build}}: python setup.py build

Go

{{install}}: go mod download
{{dev}}: go run .
{{test}}: go test ./...
{{build}}: go build

Rust

{{install}}: cargo build
{{dev}}: cargo run
{{test}}: cargo test
{{build}}: cargo build --release

Agent Usage

When an agent needs to run a command:

1. •Check .claude/commands.md for the correct command
2. •Use the command exactly as specified
3. •If a command is missing, ask the user or check package.json/equivalent

Updating Commands

If you discover the correct command for an action:

1. •Update .claude/commands.md with the correct command
2. •Ensure other agents can find it in the future