---
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. |
