Skills / Tools
SKILL.md generator and checker
Write a valid skill file for Claude Code, Codex and other agents in a minute, or paste one to find what is wrong with it.
Your SKILL.md
Description: 133 / 1024 characters
---
name: weekly-status-email
description: Turns meeting notes into a short weekly status email. Use when the user pastes meeting notes and asks for a status update or summary.
---
1. Group the notes by project.
2. For each project, list what was done, what is next, and anything blocked.
3. Keep the email under 200 words and end with open questions.
- No problems found. This SKILL.md follows the Agent Skills spec.
Save it as:
Claude Code: ~/.claude/skills/weekly-status-email/SKILL.md
Codex: ~/.agents/skills/weekly-status-email/SKILL.md
What the checker looks for
The rules come from the open Agent Skills specification that Claude Code, Codex and other agents follow:
| Field | Rule |
|---|---|
name | Required. 1–64 characters, lowercase letters, numbers and hyphens, no leading, trailing or double hyphens. Should match the folder name. |
description | Required. Up to 1024 characters. Say what the skill does and when to use it; agents choose skills from this text. |
license | Optional. A license name or a bundled license file. |
compatibility | Optional. Up to 500 characters on environment needs, such as required tools or network access. |
metadata, allowed-tools | Optional. Extra key-value data, and pre-approved tools (experimental). |
| Body | The instructions after the frontmatter. Keep it under about 500 lines and move long material into reference files. |
It also flags fields only Claude Code reads, such as disable-model-invocation, when_to_use and context, so you know other agents will ignore them, and catches misspelled fields, which agents skip without any error.
Tips for a skill that actually triggers
- Put the main use case first in the description. Some agents shorten descriptions when many skills are installed.
- Use the words people really type: "status update", "weekly report", not only "summarise".
- One job per skill. Two jobs make the description vague and the skill harder to choose.
- Test it: ask for the task in three different ways and see if the skill starts. Anthropic's skill-creator automates this.
New to skills? Read what Claude skills are or the Codex skills guide.