Loading...
Loading...
Create slash commands for Claude Code with $ARGUMENTS handling, agent invocation patterns, and template best practices. Reference for building user-triggered workflow shortcuts.
npx skill4agent add vasilyu1983/ai-agents-public claude-code-commands.claude/skills/<name>/SKILL.md.claude/commands/<name>.md$ARGUMENTS| Component | Purpose | Example |
|---|---|---|
| Filename | Command name | |
| Content | Prompt template | Instructions for Claude |
| User input | |
| Positional args | |
| Session tracking | |
| Include file | |
| Bash output (preprocessing) | |
| Location | Scope | Creates | Use For |
|---|---|---|---|
| Project | | Recommended: team-shared commands with supporting files |
| Personal | | Personal cross-project commands |
| Project | | Legacy single-file commands (still supported) |
| Personal | | Legacy personal commands |
| Nested | | Monorepo subdirectories |
.claude/skills/.claude/commands/.claude/skills/
|-- review/SKILL.md # /review
|-- test/SKILL.md # /test
`-- deploy/SKILL.md # /deploy.claude/commands/
|-- review.md # /review
|-- test.md # /test
`-- deploy.md # /deploy---
name: command-name
description: Brief description for invocation and auto-loading
argument-hint: [path|#pr] [options]
allowed-tools: Read, Grep, Bash(git:*)
disable-model-invocation: false
---
# Command Title
[Clear instructions for what this command does]
User request: $ARGUMENTS
## Steps
1. [First action Claude should take]
2. [Second action]
3. [Third action]
## Output Format
[Specify expected output structure]| Field | Purpose |
|---|---|
| Slash command name (kebab-case) |
| When to use this skill/command |
| Hint shown during autocomplete for expected arguments |
| Tools this skill can run without extra prompts |
| If |
| If |
| Override the model for this skill |
| Use |
| Subagent used to execute this skill |
| Optional lifecycle hooks for the skill |
.claude/commands/*.mdallowed-tools: Read, Grep, Bash(git:*)| Pattern | Meaning |
|---|---|
| Allow any invocation of that tool |
| Allow with specific prefix only |
| Only git commands |
| Only npm test commands |
# Code Review
Review the following file or code for quality, security, and best practices:
$ARGUMENTS
Focus on:
- Code quality issues
- Security vulnerabilities
- Performance concerns
- Best practice violations/review src/auth.js# Compare Files
Compare these two files and explain the differences:
$ARGUMENTS
Provide:
- Line-by-line diff
- Semantic changes
- Impact analysis/compare old.js new.js# Run Tests
Run tests for the specified scope.
Scope: $ARGUMENTS
If no scope specified, run all tests.
If scope is a file, run tests for that file.
If scope is a directory, run tests in that directory./test/test auth//test login.test.ts$1$2# Compare Files
Compare $1 with $2.
Show:
- Line differences
- Semantic changes
- Which version is preferred/compare old.js new.js$1 = "old.js"$2 = "new.js"@# Review with Context
Review this code following our standards.
Project standards:
@CLAUDE.md
Code to review:
$ARGUMENTS/review-context src/auth.js!# Smart Commit
Current status:
!git status --short
Recent commits:
!git log --oneline -5
Staged changes:
!git diff --cached
Generate a commit message for the staged changes./smart-commit!commandPR diff: !`gh pr diff`
Changed files: !`gh pr diff --name-only`# Security Audit
Perform a comprehensive security audit.
Target: $ARGUMENTS
Use the **security-auditor** agent to:
1. Scan for OWASP Top 10 vulnerabilities
2. Check authentication patterns
3. Review data validation
4. Analyze dependencies
Provide a severity-rated findings report.# Fullstack Feature
Build a complete fullstack feature.
Feature: $ARGUMENTS
Workflow:
1. Use **prd-architect** to clarify requirements
2. Use **system-architect** to design approach
3. Use **backend-engineer** for API implementation
4. Use **frontend-engineer** for UI implementation
5. Use **test-architect** for test coverage
Coordinate between agents and ensure integration.# Pre-Commit Check
Validate changes before commit.
Files: $ARGUMENTS (or all staged files if not specified)
Checklist:
- [ ] All tests pass
- [ ] No linting errors
- [ ] No type errors
- [ ] No console.log statements
- [ ] No TODO comments
- [ ] No hardcoded secrets
Return READY or BLOCKED with details.| Command | Purpose |
|---|---|
| Code review |
| Run/write tests |
| Debug issues |
| Improve code |
| Command | Purpose |
|---|---|
| System design |
| Review architecture |
| Write tech spec |
| Command | Purpose |
|---|---|
| Security audit |
| Find exposed secrets |
| Check dependencies |
| Command | Purpose |
|---|---|
| Deployment workflow |
| Rollback changes |
| Incident response |
| Pattern | Example | Use For |
|---|---|---|
| | Simple actions |
| | Specific targets |
| | Domain-prefixed |
| | Tool-specific |
| Feature | Command | Agent | Skill |
|---|---|---|---|
| Trigger | User types | Claude decides | Claude loads |
| Purpose | Quick shortcuts | Complex work | Knowledge |
| Statefulness | Stateless | Maintains context | Reference only |
| Length | Short prompt | Full instructions | Detailed docs |
| Frontmatter | User Invokes | Claude Invokes | Use Case |
|---|---|---|---|
| (default) | Yes ( | Yes (auto) | General commands |
| Yes ( | No (never) | Deploy, commit, dangerous ops |
| No (hidden) | Yes (auto) | Background knowledge only |
---
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(kubectl:*), Bash(docker:*)
---
# Deploy
Deploy $ARGUMENTS to production cluster./deployexport SLASH_COMMAND_TOOL_CHAR_BUDGET=20000/context# Good Command
Clear, specific instructions.
Target: $ARGUMENTS
1. First, analyze the target
2. Then, perform action X
3. Finally, output result Y
Expected output:
- Summary of findings
- Actionable recommendations# Bad Command
Do stuff with $ARGUMENTS.
Make it good.# Smart Review
Review target: $ARGUMENTS
If target is a PR number (e.g., #123):
- Fetch PR details with `gh pr view`
- Review all changed files
If target is a file path:
- Review that specific file
If target is a directory:
- Review all files in directory# Generate Tests
Generate tests for: $ARGUMENTS
Options (parsed from arguments):
- `--unit` - Unit tests only
- `--e2e` - E2E tests only
- `--coverage` - Include coverage report
Default: Generate both unit and E2E tests.