SkillsBot.org

SKILL.md Validator

Paste a SKILL.md to check it against the Agent Skills specification and Claude Code's rules before you publish or install it.

Paste a SKILL.md and press Validate. Nothing leaves your browser.

    The check runs entirely in your browser. Nothing you paste is uploaded.

    How to use the validator

    1. Paste the full contents of your SKILL.md, including the --- lines.
    2. Type the skill's folder name if you want to check that it matches name.
    3. Press Validate. Errors must be fixed; warnings are suggestions.

    The rules it checks

    Field Rule
    Frontmatter The file starts with --- on the first line and the YAML block closes with ---
    name 1–64 characters; lowercase letters, numbers and hyphens; no leading, trailing or double hyphens; same as the folder name
    description Required; up to 1,024 characters; says what the skill does and when to use it
    compatibility Optional; up to 500 characters
    metadata Optional; a map of keys to values

    These come from the open Agent Skills specification. The validator also knows the extra fields Claude Code reads, such as disable-model-invocation, user-invocable, allowed-tools, paths and context, and points out when you use them, because other agents may ignore them.

    Claude Code has two limits worth knowing: it shows at most 1,536 characters of description plus when_to_use in its skill list, and it will not load a personal or project skill named synced or starting with anthropic-skills.

    A good SKILL.md, briefly

    • Description first. It is the only part Claude sees until the skill is needed. Name the task, the file types and the phrases a user would say.
    • Short body, linked details. The whole file loads when the skill runs. Keep steps and examples in SKILL.md and move long reference material into separate files.
    • Steps, examples, edge cases. The specification recommends these three kinds of section.

    Once it validates, follow the install guide to try it in Claude Code, or study how published skills are written in the directory. Anthropic's skill-creator can also test a skill for you.

    SKILL.md validator: FAQ

    What does the SKILL.md validator check?

    That the file opens with YAML frontmatter, that name and description exist and follow the Agent Skills rules (name up to 64 lowercase letters, numbers and hyphens; description up to 1,024 characters), that the name matches the folder, and that nothing in the frontmatter will be silently ignored.

    Is my SKILL.md uploaded anywhere?

    No. The check runs in your browser. Nothing you paste is sent to our server.

    Why does my skill not trigger even though it validates?

    Claude picks skills by their description. Make the description say what the skill does and when to use it, using the words people actually type, and put the most important use case first.

    Does Claude Code require the name field?

    No. Claude Code falls back to the folder name. The Agent Skills specification requires name, so include it if you want the skill to work in other agents too.