common-workflow-writing
Installation
SKILL.md
Workflow Writing Standard
Priority: P0 (CRITICAL)
Core Rules
- Templates, not examples: Workflows define structure, not pre-filled data. agent generates data at runtime.
- No example rows in tables: Include headers + 1 skeleton row only. Never populate with fake data.
- No prose explanations: If bullet or command achieves same result, delete paragraph.
- No pre-answered questions: Don't document what agent will output — let it output it.
- Merge sequential steps: If two steps always happen together, they one step.
Size Limits
| File type | Limit | If exceeded |
|---|---|---|
Workflow .md |
80 lines | Extract detail to references/ |
| SKILL.md | 100 lines | Extract examples to references/ |
| Table rows | 8 | Extract to references/ |
| Inline code block | 10 lines | Extract to references/ |