Example Skill

Create a new Codex skill from a concise, validated template.

kastabala Updated

File contents

Example Skill

When To Use

Use this skill when converting a proven workflow, checklist, or repeatable review pattern into a reusable Codex skill.

Workflow

  1. Create the skill at .agents/skills/<skill-name>/.
  2. Add SKILL.md with YAML frontmatter containing non-empty name and a concise, front-loaded description.
  3. Put only core trigger rules and workflow steps in SKILL.md.
  4. Add references/ only for background material that should be loaded conditionally.
  5. Add scripts/ only for deterministic checks or repeated operations.
  6. Add assets/ only for templates or binary resources used by the skill.
  7. Add agents/openai.yaml only when UI metadata, policy, or dependencies are useful.
  8. If this template validator is present, run scripts/check.sh; otherwise validate SKILL.md frontmatter and any optional metadata with the repo's available checks.

Scripts

  • Run scripts/check.sh after editing this skill template.

kastabala/Kastabala-Awesome-Skills/tree/main/.agents/skills/example-skill commit 447f5f68c4

Frequently asked questions

npx skillmds@latest add kastabala/example-skill