Skip to content

Commit 8ca4b9c

Browse files
sjnimsclaude
andcommitted
docs: update component patterns for new frontmatter fields
CLAUDE.md: - Add skills field to agents section - Change tools format from array to comma-separated - Add model and disable-model-invocation to commands section CONTRIBUTING.md: - Update command/skill/agent counts (2 commands, 8 skills) - Fix YAML examples to use comma-separated format - Add skills field to agent example - Remove incorrect name field from command example 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 045d418 commit 8ca4b9c

2 files changed

Lines changed: 15 additions & 11 deletions

File tree

CLAUDE.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,8 @@ Agents require YAML frontmatter with:
136136
- `description`: Starts with "Use this agent when...", includes `<example>` blocks
137137
- `model`: inherit/sonnet/opus/haiku
138138
- `color`: blue/cyan/green/yellow/magenta/red
139-
- `tools`: Array of allowed tools (optional)
139+
- `tools`: Comma-separated list of allowed tools (optional)
140+
- `skills`: Comma-separated list of skills the agent can load (optional)
140141

141142
### Skills
142143

@@ -153,7 +154,9 @@ Commands are markdown files with frontmatter:
153154

154155
- `description`: Brief explanation (required)
155156
- `argument-hint`: Optional argument placeholder text
156-
- `allowed-tools`: Optional array of permitted tools (restricts tool access)
157+
- `allowed-tools`: Comma-separated list of permitted tools (restricts tool access)
158+
- `model`: Model to use for command execution (inherit/sonnet/opus/haiku)
159+
- `disable-model-invocation`: Set to `true` to prevent model invocation in subagents (for workflow commands that delegate to specialized agents)
157160

158161
### Skills/Agents Optional Frontmatter
159162

CONTRIBUTING.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -47,15 +47,15 @@ Before contributing, ensure you have:
4747
2. **Explore the architecture**:
4848
```
4949
plugins/plugin-dev/
50-
├── commands/ # 1 slash command
51-
├── skills/ # 7 methodology skills
50+
├── commands/ # 2 slash commands
51+
├── skills/ # 8 skills
5252
└── agents/ # 3 specialized agents
5353
```
5454

5555
3. **Understand the plugin components**:
56-
- 7 skills for different plugin development aspects
56+
- 8 skills for different plugin development aspects
5757
- 3 agents for validation and generation
58-
- 1 guided workflow command (`/plugin-dev:create-plugin`)
58+
- 2 guided workflow commands (`/plugin-dev:create-plugin`, `/plugin-dev:create-marketplace`)
5959

6060
## Development Setup
6161

@@ -159,9 +159,9 @@ When creating or modifying commands:
159159
1. **YAML Frontmatter Required**:
160160
```yaml
161161
---
162-
name: command-name
163162
description: Brief description
164-
allowed-tools: [AskUserQuestion, Bash(gh:*), Read]
163+
argument-hint: [optional-argument]
164+
allowed-tools: AskUserQuestion, Bash(gh:*), Read
165165
---
166166
```
167167

@@ -211,15 +211,16 @@ When creating or modifying agents:
211211
description: Use this agent when...
212212
model: inherit
213213
color: blue
214-
tools: [Bash, AskUserQuestion]
214+
tools: Bash, AskUserQuestion
215+
skills: skill-name-1, skill-name-2
215216
---
216217
```
217218

218219
2. **Trigger Examples**: Include 3-4 `<example>` blocks showing when the agent should trigger
219220

220221
3. **Clear System Prompt**: Be specific about the agent's role and responsibilities
221222

222-
4. **Minimal Tools**: Only include tools the agent actually needs
223+
4. **Minimal Tools/Skills**: Only include tools and skills the agent actually needs
223224

224225
### Hooks
225226

@@ -352,7 +353,7 @@ See [pull_request_template.md](.github/pull_request_template.md) for the complet
352353

353354
- Always include required fields (`name`, `description`)
354355
- Use consistent indentation (2 spaces)
355-
- Use arrays for lists: `[Tool1, Tool2]`
356+
- Use comma-separated lists for tools/skills: `Tool1, Tool2`
356357

357358
### Commands and Instructions
358359

0 commit comments

Comments
 (0)