1.3 KiB
1.3 KiB
| model_tier | 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. |