Skill templates/Open standard (any agent)

SKILL.md Template (Agent Skills open standard)

The Agent Skills open standard (agentskills.io) defines a vendor-neutral SKILL.md: a name, a description of when to use it, and the workflow. Claude Code and Codex both implement it.

Where it lives

Open standard.agents/skills/<name>/SKILL.md

Most tools load the skill when the task matches its description, or let you invoke it by name. Keep the description scoped and trigger-word-rich.

Skill structure

structure

my-skill/
├── SKILL.md      (required)
├── scripts/      (optional)
├── references/   (optional)
└── assets/       (optional)

Copy the SKILL.md

SKILL.md

---
name: ci-failure-fix
description: Use when CI is red and the failure is a concrete, reproducible check. Do not use for flaky infrastructure or product decisions.
---
 
# CI Failure Fix
 
## When to Use This Skill
Use when CI is red and the failure is a concrete, reproducible check.
 
## When Not to Use This Skill
Do not use for flaky infrastructure, secrets issues, or product decisions.
 
## Workflow
1. Read the CI logs and identify the failing check.
2. Reproduce the failure locally.
3. Apply the smallest fix.
4. Re-run the full relevant suite.
5. Summarize the root cause.
 
## Validation
- The CI command passes locally.
- The same failing test now passes.
- No unrelated tests are skipped or deleted.
 
## Safety Rules
- Do not remove failing tests.
- Do not disable lint or type checks.
- Stop and escalate if blocked.

Customize it in the SKILL.md Generator

Good skill checklist

Front-load the key use case and trigger words in the description
Say clearly when the skill should and should not trigger
Keep the SKILL.md body short; move long material to references/
Make validation machine-checkable
Include explicit safety rules and an escalation condition

Sources

Agent Skills standard Codex — Agent Skills