agents-skills

# Agent Skills Use this skill to create or modernize skill bundles without conflating the portable core contract with runtime-specific extensions. > **Scope — this is a delta on the standard, not a replacement.** Generic skill authoring, scaffolding, and eval mechanics are owned by the [Agent Skills open spec](https://agentskills.io/specification) and the standard `skill-creator` skill (and `plugin-dev:skill-development`). Use those for boilerplate. This skill owns only the repo-specific delta the standard cannot provide: dual-runtime portability (Claude Code + Codex), catalog/graph gating, and router/composition patterns. Do not replicate the standard here — link to it. ## Quick Reference | Task | Read or Run | Outcome | |------|-------------|---------| | Scaffold a new skill | `skill-creator` (standard skill) | Generates the boilerplate; then apply portability discipline from `references/frontmatter-reference.md` | | Modernize an existing skill | `python3 scripts/validate_skill.py <skill-dir>` | Finds contract drift, broken links, stale sources, and missing TOCs | | Add runtime-specific metadata | `references/frontmatter-reference.md` | Scopes extensions to the target runtime instead of treating them as universal | | Decide how to split content | `references/skill-patterns.md` | Keeps `SKILL.md` small and moves detail into `references/` or `scripts/` | | Validate behavior, not just syntax | `references/skill-validation.md` | Builds trigger, non-trigger, and navigation e...