agents-skills
Installation
SKILL.md
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 and the standard
skill-creatorskill (andplugin-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 evals |
| Check Anthropic-specific details | references/anthropic-skills-guide.md |
Uses Anthropic guidance without treating it as the portable baseline |
| Ship one skill to multiple runtimes without drift | references/dual-distribution.md |
Single canonical system prompt + wrapper distributions + drift-check gate |
| Design router/composable skill flow | references/skill-patterns.md#pattern-10-stage-based-selection-pipeline |
Separates sources, enrichment, filters, scoring, selection, validation, and side effects |