48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
---
|
|
model_tier:
|
|
all_steps: main
|
|
note: "Lightweight workflow - can be executed inline without subagent"
|
|
---
|
|
|
|
# Workflow: Generate Description
|
|
|
|
## When to use
|
|
|
|
- Writing frontmatter for skill, agent, command, or plugin
|
|
- Called by other architect skills
|
|
|
|
## Inputs required
|
|
|
|
- **type** - skill, agent, command, or plugin
|
|
- **name** - kebab-case
|
|
- **purpose** - What it does / problem it solves
|
|
- **triggers** - When AI should use this
|
|
|
|
## Process
|
|
|
|
### 1. Read the formula
|
|
Read: `${CLAUDE_PLUGIN_ROOT}/references/layout/descriptions.md`
|
|
|
|
### 2. Draft description
|
|
Formula: `[Action verb] [what]. [Unambiguous trigger].`
|
|
- Action verb (Build, Generate, Create, Run)
|
|
- What it does (2-5 words)
|
|
- Trigger (prevents escape hatches)
|
|
|
|
### 3. Escape hatch test
|
|
"Can AI rationalize NOT using this while still doing the task?"
|
|
If yes -> rewrite trigger. Focus on immediate action, not downstream purpose.
|
|
|
|
### 4. Return
|
|
Output ONLY the description string. No explanation, no formatting.
|
|
|
|
Example: `Build Claude Code skills. Use when creating a skill.`
|
|
|
|
## Examples
|
|
|
|
| Type | Name | Result |
|
|
|------|------|--------|
|
|
| skill | skill-architect | Build Claude Code skills. Use when creating a skill. |
|
|
| agent | code-reviewer | Review code against implementation plan. Use after completing a major project step. |
|
|
| command | commit | Stage and commit changes. Use when ready to commit. |
|