SKILL.md Linter, Packager & Agent Config Converter
Check an agent skill against the Agent Skills format, bundle it as a ZIP ready for Claude Code, Codex, Cursor, Gemini CLI or Claude.ai, and convert one set of instructions between AGENTS.md, CLAUDE.md, Cursor rules, Copilot and GEMINI.md.
Paste a SKILL.md, drop a skill folder or ZIP onto the box, or try a sample. A ZIP with many skills (like the Brace library’s all.zip) is checked in one go.
| Skill | Errors | Warnings | Status |
|---|
The ZIP holds <name>/SKILL.md plus any files you add. Claude.ai takes it under Customize → Skills → Upload a skill; for other agents unzip it into their skills folder.
Paste instructions you already have and get every other tool’s version, with the right file name and front matter.
What makes a good SKILL.md
A skill is a folder with a SKILL.md file: a short YAML header with a name and a description, then instructions. The agent reads only the name and description of every installed skill at the start, and loads the full file when a request matches, so the description decides whether the skill is ever used.
The rules the linter checks
- name: up to 64 characters, lowercase letters, numbers and single hyphens, matching the folder name.
- description: up to 1024 characters, no tags, written in the third person, saying both what the skill does and when to use it.
- YAML: a description containing
:or#must be quoted, or strict parsers reject the file or drop part of the text. - Structure: clear steps and output format, under about 500 lines, with long reference material moved into linked files that exist in the folder.
- Safety: no secrets, no hidden Unicode, and no unexplained risky commands, because people install skills without reading them.
One set of instructions for every coding agent
AGENTS.md is an open format read by several agents, Claude Code reads CLAUDE.md, Gemini CLI reads GEMINI.md, Copilot reads .github/copilot-instructions.md and Cursor uses .cursor/rules/*.mdc (or the legacy .cursorrules). The converter keeps one source and produces each file with the right name and front matter, and warns about syntax that does not carry across, such as @file imports and slash commands.
How to use these tools
- Paste a SKILL.md, or drop a skill folder or ZIP, and read the checks.
- Fix errors first, then the suggestions, and add any linked files.
- Download the ZIP or copy the install command for your agent.
- To share rules across agents, paste them into the converter and download every format.
Why use them
- Catches the mistakes that stop skills from loading or triggering
- Lints a whole ZIP of skills at once
- ZIPs ready for Claude.ai, Claude Code and other agents
- Converts AGENTS.md, CLAUDE.md, Cursor, Copilot and GEMINI.md
Related tools
Frequently Asked Questions
What does the SKILL.md linter check?
It checks that the file starts with valid YAML front matter, that the name is up to 64 characters of lowercase letters, numbers and single hyphens and matches the folder, and that the description is present, up to 1024 characters, free of tags, written in the third person and says when to use the skill. It also looks at structure and length, links to missing files, secrets, hidden Unicode characters and risky commands.
Why does my description break the YAML?
In YAML an unquoted value that contains a colon followed by a space is read as a new key, and ' #' starts a comment. Strict parsers then reject the file or silently cut the description. Wrap the whole description in double quotes, escaping any inner double quotes with a backslash.
How do I upload a skill to Claude.ai?
Put the skill in a folder named after the skill, with SKILL.md inside, and zip that folder. In Claude.ai open Customize, then Skills, choose Upload a skill and select the ZIP. The Download ZIP button here builds exactly that structure, including any extra files you add.
Can it lint many skills at once?
Yes. Drop a ZIP that contains several skill folders, for example the Brace skills library ZIP, and the tool lints every SKILL.md in it and lists errors and warnings per skill. Click a row to see its details.
How do I convert CLAUDE.md to AGENTS.md or Cursor rules?
Open the Agent config converter tab and paste your CLAUDE.md, AGENTS.md, .cursorrules or Cursor .mdc content. You get AGENTS.md, CLAUDE.md, a Cursor .mdc rule with front matter, .cursorrules, GitHub Copilot instructions and GEMINI.md, each with the right file name, and you can download them all as a ZIP.
Is anything uploaded?
No. Linting, ZIP building and conversion all run in your browser. Files you drop or paste never leave your device.