Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/skills/cloudflare/references/waf/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ contains; // Substring match
matches; // Regex match (use carefully)
starts_with; // Prefix match
ends_with in // Suffix match
// Value in list
// Value in list
// List operations
not; // Logical NOT
and; // Logical AND
Expand Down
26 changes: 19 additions & 7 deletions .agents/skills/command-development/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ Comprehensive guidance on creating Claude Code slash commands, including file fo
## Overview

This skill provides knowledge about:

- Slash command file format and structure
- YAML frontmatter configuration fields
- Dynamic arguments ($ARGUMENTS, $1, $2, etc.)
Expand All @@ -23,6 +24,7 @@ This skill provides knowledge about:
Core skill content covering:

**Fundamentals:**

- Command basics and locations
- File format (Markdown with optional frontmatter)
- YAML frontmatter fields overview
Expand All @@ -34,6 +36,7 @@ Core skill content covering:
- Troubleshooting

**Plugin-Specific:**

- ${CLAUDE_PLUGIN_ROOT} environment variable
- Plugin command discovery and organization
- Plugin command patterns (configuration, template, multi-script)
Expand Down Expand Up @@ -82,6 +85,7 @@ Practical command examples:
## When This Skill Triggers

Claude Code activates this skill when users:

- Ask to "create a slash command" or "add a command"
- Need to "write a custom command"
- Want to "define command arguments"
Expand Down Expand Up @@ -122,6 +126,7 @@ allowed-tools: Read, Bash(git:*)
---

Command prompt content with:

- Arguments: $1, $2, or $ARGUMENTS
- Files: @path/to/file
- Bash: !`command here`
Expand All @@ -136,24 +141,27 @@ Command prompt content with:
### Key Features

**Dynamic arguments:**

- `$ARGUMENTS` - All arguments as single string
- `$1`, `$2`, `$3` - Positional arguments

**File references:**

- `@path/to/file` - Include file contents

**Bash execution:**

- `!`command`` - Execute and include output

## Frontmatter Fields Quick Reference

| Field | Purpose | Example |
|-------|---------|---------|
| `description` | Brief description for /help | `"Review code for issues"` |
| `allowed-tools` | Restrict tool access | `Read, Bash(git:*)` |
| `model` | Specify model | `sonnet`, `opus`, `haiku` |
| `argument-hint` | Document arguments | `[pr-number] [priority]` |
| `disable-model-invocation` | Manual-only command | `true` |
| Field | Purpose | Example |
| -------------------------- | --------------------------- | -------------------------- |
| `description` | Brief description for /help | `"Review code for issues"` |
| `allowed-tools` | Restrict tool access | `Read, Bash(git:*)` |
| `model` | Specify model | `sonnet`, `opus`, `haiku` |
| `argument-hint` | Document arguments | `[pr-number] [priority]` |
| `disable-model-invocation` | Manual-only command | `true` |

## Common Patterns

Expand Down Expand Up @@ -243,11 +251,13 @@ Recent commits: !`git log --oneline -5`
## Status

**Completed enhancements:**

- ✓ Plugin command patterns (${CLAUDE_PLUGIN_ROOT}, discovery, organization)
- ✓ Integration patterns (agents, skills, hooks coordination)
- ✓ Validation patterns (input, file, resource validation, error handling)

**Remaining enhancements (in progress):**

- Advanced workflows (multi-step command sequences)
- Testing strategies (how to test commands effectively)
- Documentation patterns (command documentation best practices)
Expand All @@ -256,6 +266,7 @@ Recent commits: !`git log --oneline -5`
## Maintenance

To update this skill:

1. Keep SKILL.md focused on core fundamentals
2. Move detailed specifications to references/
3. Add new examples/ for different use cases
Expand All @@ -266,6 +277,7 @@ To update this skill:
## Version History

**v0.1.0** (2025-01-15):

- Initial release with basic command fundamentals
- Frontmatter field reference
- 10 simple command examples
Expand Down
Loading
Loading