skill-creator

name	skill-creator
description	Guide for creating effective skills. Use when creating or updating a skill.

Skill Creator

Use this skill when defining or updating reusable Codex skills.

Workflow

1. Workspace-local skills always live under skills/ at the workspace root.
2. Create or update each workspace skill under skills/<skill-id>/ and save SKILL.md plus any helper files there.
3. This embedded skill is guidance only: do not write new workspace skills into runtime/harnesses/src/embedded-skills/.
4. Clarify the task and gather concrete examples.
5. Define minimal reusable structure and naming.
6. Enforce canonical SKILL.md format:
   • frontmatter is required and must include:
     • name: <skill-id> (must exactly match the directory name under skills/)
     • description: <one-line summary>
   • markdown body starts after frontmatter and contains practical usage guidance.
7. Start from this template and fill in concrete content:

---
name: <skill-id>
description: <one-line summary>
---

# <Readable Skill Title>

## When To Use
- ...

## Workflow
1. ...
2. ...

## Examples
- ...

8. Keep SKILL.md concise; use references/scripts only when needed.
9. Validate with a real invocation path.
10. Iterate from usage feedback.