md-generation-standard

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