ee0f4bd5d9
- Add comprehensive built-in commands reference (40+ commands) - Document argument handling ($ARGUMENTS, $1, $2, etc.) - Add bash execution syntax (! prefix) and file references (@ prefix) - Update frontmatter to official fields (allowed-tools, argument-hint, model, etc.) - Add Plugin Commands and MCP Slash Commands sections - Add SlashCommand Tool documentation for programmatic invocation - Add Skills vs Slash Commands comparison table - Create commit.md example with bash execution and context - Update existing examples to use official frontmatter format - Add OpenSpec proposal for change tracking
34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
# Change: Update Slash Commands Documentation
|
|
|
|
## Why
|
|
|
|
The current slash commands documentation in `01-slash-commands/README.md` is outdated compared to the official Claude Code documentation at https://code.claude.com/docs/en/slash-commands. Several new features, built-in commands, and capabilities have been added that users should know about.
|
|
|
|
## What Changes
|
|
|
|
### Documentation Updates
|
|
|
|
- **Add comprehensive built-in commands table** - Document all 40+ built-in slash commands with their purposes
|
|
- **Update custom command features** - Document new argument handling (`$ARGUMENTS`, `$1`, `$2`, etc.)
|
|
- **Add bash execution syntax** - Document the `!` prefix for executing bash commands within slash commands
|
|
- **Update frontmatter fields** - Document `allowed-tools`, `argument-hint`, `description`, `model`, `disable-model-invocation`
|
|
- **Add file reference syntax** - Document the `@` prefix for including file contents
|
|
- **Add Plugin commands section** - Document `/plugin-name:command-name` pattern
|
|
- **Add MCP slash commands section** - Document `/mcp__<server-name>__<prompt-name>` pattern
|
|
- **Add SlashCommand Tool section** - Document programmatic invocation from Claude
|
|
- **Add Skills vs Slash Commands comparison** - Help users choose the right tool
|
|
|
|
### Example Updates
|
|
|
|
- Add example command with bash execution (`!git status`)
|
|
- Add example with file references (`@src/utils/helpers.js`)
|
|
- Add example with complete frontmatter
|
|
- Update existing examples to use official syntax
|
|
|
|
## Impact
|
|
|
|
- Affected specs: `slash-commands` (new capability spec to be created)
|
|
- Affected code: `01-slash-commands/README.md`, potentially new example files
|
|
- No breaking changes - additive documentation improvements
|
|
- Benefits all users learning about Claude Code slash commands
|