By name: MD Generation Standard description: Apply consistent frontmatter, structure, and path references across authored markdown files
MD Generation Standard
Description
Use this skill when writing agent, skill, and rule documents for the Codex layer.
Users
.codex/agents/generation/agent-writer.md.codex/agents/generation/skill-writer.md.codex/agents/generation/rule-writer.md
Format Rules
Frontmatter
Agent docs:
---
name: {Agent name}
description: {One sentence description}
agent_type: {default | worker | explorer}
---
Skill docs:
---
name: {Skill name}
description: {One sentence description}
---
Rule docs:
---
name: {Rule name}
description: {One sentence description}
---
Path References
- skill path:
.agents/skills/{skill-name}/SKILL.md - authored skill path:
.codex/skills/{skill-name}/SKILL.md - agent path:
.codex/agents/{group}/{agent-name}.md - rule path:
.codex/rules/{rule-name}.md
Writing Style
- one
#heading per file - imperative language
- kebab-case file names
- keep paths exact
Checklist
- frontmatter is present and valid
- only one h1 exists
- all paths resolve
- no vague fillers remain
- the file stays within the size budget
Example
Input
請為 reviewer 角色產出 agent prompt。
Output
frontmatter + Identity + Responsibilities + Input and Output + Workflow + Available Skills + Applicable Rules + Collaboration Relationships + Boundaries