command-dev
Use this skill when creating or refining custom Claude Code slash commands. Slash commands are user-invoked reusable prompts that can accept arguments, reference files, and execute bash operations. Helps design command syntax, argument handling, file references, bash execution, and frontmatter configuration. Automatically invoked when user requests "create a command", "make a slash command", "add a /command", or mentions custom command development.
andisab · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add andisab/swe-marketplace --skill command-dev技能说明
name: command-dev description: > Use this skill when creating or refining custom Claude Code slash commands. Slash commands are user-invoked reusable prompts that can accept arguments, reference files, and execute bash operations. Helps design command syntax, argument handling, file references, bash execution, and frontmatter configuration. Automatically invoked when user requests "create a command", "make a slash command", "add a /command", or mentions custom command development. allowed-tools: Read, Write, Edit, Grep, Glob, Bash(ls:), Bash(tree:)
Command Dev Skill
This skill helps create production-ready custom slash commands following Anthropic's official specifications.
What is a Slash Command?
A slash command is a user-invoked reusable prompt stored as a Markdown file. Unlike skills (model-invoked) or agents (complex AI assistants), slash commands are:
- User-triggered: Explicitly invoked with
/command-name - Template-based: Expand to prompts with placeholders
- Lightweight: Simple Markdown files with optional frontmatter
- Quick access: Fast way to reuse common instructions
Commands vs Skills vs Agents
| Feature | Command | Skill | Agent |
|---|---|---|---|
| Invocation | User (/name) | Model (automatic) | User or Task tool |
| Complexity | Simple prompt template | Capability with logic | Full AI assistant |
| Arguments | Yes ($1, $2, $ARGUMENTS) | N/A | N/A |
| File access | Yes (@file) | Via tools | Via tools |
| Bash exec | Yes (!command) | Via tools | Via tools |
| Use case | Quick prompts, workflows | Autonomous features | Domain expertise |
When to use Commands: Reusable prompts, quick text expansion, parametrized instructions, file processing workflows
Command Structure
Basic Command (Prompt only)
Please review this code for security vulnerabilities and provide
specific recommendations for improvement.
File: .claude/commands/security-review.md
Usage: /security-review
Command with Frontmatter
---
description: Review code for security vulnerabilities with OWASP focus
argument-hint: [file-path] [--strict]
allowed-tools: Read, Grep, Glob
model: opus
disable-model-invocation: false
---
Please perform a comprehensive security audit of the codebase, focusing on:
- OWASP Top 10 vulnerabilities
- Authentication and authorization issues
- Input validation and sanitization
- Secrets exposure
Frontmatter Fields
All frontmatter fields are optional.
description
Brief explanation shown in /help and for SlashCommand tool.
description: Generate comprehensive API documentation from OpenAPI spec
Best practices:
- 1 sentence, concise
- Describe what it does, not how
- Include key features
argument-hint
Expected arguments for autocomplete and help.
argument-hint: <endpoint-url> [--format json|yaml]
argument-hint: [file-pattern]
argument-hint: <branch-name>
Syntax conventions:
<required>- Required argument[optional]- Optional argument|- Choice between options
allowed-tools
Restrict which tools the command can use.
allowed-tools: Read, Write, Grep, Glob
allowed-tools: Bash(git:*), Bash(npm:*)
allowed-tools: Read, WebFetch
Why restrict:
- Security: Prevent dangerous operations
- Focus: Command only needs specific tools
- Safety: Avoid accidental file modifications
model
Override the model for this command.
model: opus # Complex reasoning
model: sonnet # Balanced (default)
model: haiku # Fast, simple tasks
disable-model-invocation
Prevent SlashCommand tool from invoking this command.
disable-model-invocation: true # Only user can invoke
disable-model-invocation: false # Claude can invoke (default)
Use cases:
- Private commands for personal use only
- Commands with dangerous operations
- Commands requiring user confirmation
Argument Handling
$ARGUMENTS
Captures all passed arguments as a single value.
Please analyze the following: $ARGUMENTS
Usage:
/analyze-text This is some text to analyze
Expands to:
Please analyze the following: This is some text to analyze
$1, $2, $3, ... (Positional Arguments)
Access individual arguments by position.
Compare $1 with $2 and explain the differences in $3 format.
Usage:
/compare file1.py file2.py detailed
Expands to:
Compare file1.py with file2.py and explain the differences in detailed format.
Default Values
Provide defaults for missing arguments.
Run tests in ${1:-development} environment with ${2:-verbose} output.
Usage:
/run-tests
Expands to:
Run tests in development environment with verbose output.
Usage with arguments:
/run-tests production quiet
Expands to:
Run tests in production environment with quiet output.
Combining Arguments
---
argument-hint: <action> <target> [options]
---
Execute $1 on $2 with options: $3
Fallback environment: ${3:-default}
All arguments: $ARGUMENTS
File References
@file Syntax
Include file contents in the prompt.
Please review this code:
@src/api/users.py
Focus on error handling and security.
When invoked, Claude reads src/api/users.py and includes its contents.
Multiple Files
Compare these two implementations:
**Old version:**
@src/legacy/auth.py
**New version:**
@src/current/auth.py
Highlight improvements and potential issues.
File Arguments
Review the file: @$1
And compare with: @$2
Usage:
/compare-files old-code.py new-code.py
File Patterns (with Glob)
Analyze all TypeScript files in the components directory.
Use the Glob tool to find files matching: src/components/**/*.tsx
Bash Execution
! Prefix for Bash Commands
Execute bash commands and
阅读完整来源 ↗