Commit 95999ca
docs(command-development): add SlashCommand tool coverage (#56)
## Summary
- Add comprehensive documentation for how Claude programmatically
invokes slash commands via the SlashCommand tool
- Create new reference file covering visibility requirements, character
budget, permission rules, and best practices
- Update skill description with trigger phrases for discoverability
## Problem
Fixes #48
The command-development skill documents the `disable-model-invocation`
frontmatter field but doesn't explain its relationship to the
SlashCommand tool. Users need to understand:
- What the SlashCommand tool is and when Claude uses it
- Why commands need `description` for visibility
- How the character budget (15,000 default) works
- Permission rule patterns for controlling programmatic invocation
## Solution
Created `references/slashcommand-tool.md` with complete coverage:
1. **SlashCommand Tool Overview** - What it does and when Claude uses it
2. **Visibility Requirements** - Why `description` field is required
3. **Character Budget** - 15,000 default,
`SLASH_COMMAND_TOOL_CHAR_BUDGET` env var
4. **Permission Rules** - Exact match, prefix match, deny patterns
5. **disable-model-invocation Context** - When to use vs permission
rules
6. **Integration Patterns** - Commands designed for programmatic vs
manual use
7. **Troubleshooting** - Common issues and solutions
8. **Best Practices** - For command authors and users
Updated SKILL.md:
- Added trigger phrases: "SlashCommand tool", "programmatic command
invocation", "disable-model-invocation", "prevent Claude from running
command"
- Added reference to new file in Additional Resources section
### Alternatives Considered
- **Expand frontmatter-reference.md** - Rejected because SlashCommand
tool deserves dedicated coverage beyond just frontmatter syntax
- **Add to SKILL.md directly** - Rejected to follow progressive
disclosure pattern (keep SKILL.md lean)
## Changes
-
`plugins/plugin-dev/skills/command-development/references/slashcommand-tool.md`
- New reference file (~420 lines)
- `plugins/plugin-dev/skills/command-development/SKILL.md` - Updated
description and Additional Resources
## Testing
- [x] markdownlint passes on both files
- [x] Progressive disclosure pattern followed (detailed content in
references/)
- [x] Trigger phrases align with issue requirements
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>1 parent bcac5a5 commit 95999ca
2 files changed
Lines changed: 420 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
701 | 701 | | |
702 | 702 | | |
703 | 703 | | |
| 704 | + | |
704 | 705 | | |
705 | 706 | | |
706 | 707 | | |
| |||
0 commit comments