> common-workflow-writing
Rules for writing concise, token-efficient workflow and skill files. Prevents over-building that requires costly optimization passes. (triggers: .agent/workflows/*.md, SKILL.md, create workflow, write workflow, new skill, new workflow)
curl "https://skillshub.wtf/HoangNguyen0403/agent-skills-standard/common-workflow-writing?format=md"Workflow Writing Standard
Priority: P0 (CRITICAL)
Core Rules
- Templates, not examples: Workflows define structure, not pre-filled data. The 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 a bullet or command achieves the same result, delete the paragraph.
- No pre-answered questions: Don't document what the agent will output — let it output it.
- Merge sequential steps: If two steps always happen together, they are 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/ |
Workflow Structure (Required order)
1. Goal (1 sentence)
2. Steps (imperative verb → command or checklist)
3. Output template (headers only, no pre-filled rows)
Anti-Patterns
- No verbose step preambles:
"Before we start, it's important to understand..."→ Delete - No pre-filled report rows:
| Security | P0 | ✅ PASS | CLIENT_ID moved to env |→ Delete - No repeated examples: Same concept shown twice in different formats → Keep one
- No "How to do X" sections: The step IS the instruction
- No caution blocks for obvious rules: Reserve
> ⚠️for genuinely non-obvious risks
Quick Self-Check Before Saving
- Can the agent reconstruct any removed content at runtime from context? If yes → remove it
- Is every table row real structure, not example data?
- Are there any paragraphs a bullet list could replace?
- Would cutting this in half still give the agent enough to act on?
> related_skills --same-repo
> typescript-tooling
Development tools, linting, and build config for TypeScript. Use when configuring ESLint, Prettier, Jest, Vitest, tsconfig, or any TS build tooling. (triggers: tsconfig.json, .eslintrc.*, jest.config.*, package.json, eslint, prettier, jest, vitest, build, compile, lint)
> typescript-security
Secure coding practices for TypeScript. Use when validating input, handling auth tokens, sanitizing data, or managing secrets and sensitive configuration. (triggers: **/*.ts, **/*.tsx, validate, sanitize, xss, injection, auth, password, secret, token)
> typescript-language
Modern TypeScript standards for type safety and maintainability. Use when working with types, interfaces, generics, enums, unions, or tsconfig settings. (triggers: **/*.ts, **/*.tsx, tsconfig.json, type, interface, generic, enum, union, intersection, readonly, const, namespace)
> typescript-best-practices
Idiomatic TypeScript patterns for clean, maintainable code. Use when writing or refactoring TypeScript classes, functions, modules, or async logic. (triggers: **/*.ts, **/*.tsx, class, function, module, import, export, async, promise)