Before and after
Our own public skills repository on 2026-10-04: it had grown to 15 skills, and a new one was skipped by npx skills add proskillpacks/skills --list with a YAML error. The same rule, run over our whole tree of 57 skills, found 7 descriptions with an unquoted colon (now fixed), and the checker's other warnings led us to add fallback sentences and remove a vendor tool name.
After (real output, excerpt):
$ python3 scripts/skill_check.py proskillpacks-skills/skills --quiet
skill errors warnings lines scripts
accessibility-quick-audit 0 0 39 -
changelog-from-commits 0 0 39 -
readme-first-run-check 0 0 39 -
agent-ready-quick-check 0 0 64 Python
late-payment-chaser-uk 0 0 109 Python
...
15 skill(s): 0 error(s), 0 warning(s)$ python3 scripts/skill_check.py examples/bad-yaml-colon/SKILL.md
ERROR frontmatter: line 3: description: unquoted ': ' inside the value (strict YAML reads it as a nested mapping). Quote the value or reword
See it run

What it does
A free checker for Agent Skills. Point it at a skill folder or a whole repository of skills and it reports, per SKILL.md, the things that make a skill fail to load or stop it working outside one assistant: frontmatter that strict YAML parsers reject, keys other than name and description, vendor tool names and paths, missing fallbacks, long bodies and broken links. One Python file, standard library only, with a non-zero exit code for CI.
The evidence
TESTED badge. Run on at least three real examples and scored against a written standard, with the record on file.Run over 57 real skill files. Found 7 faults strict tools reject.
Run over our own 57 skills and its four fixtures (5 checks pass). It found 7 descriptions our tools had accepted but strict YAML parsers reject, now fixed. The assistant wrapper was not model-tested.
Limits
- It reads files; it cannot tell whether a skill's instructions work or whether it triggers.
- Warnings are portability risks, not proof of breakage.
- The vendor pattern lists are not exhaustive.
Questions
Questions or a problem?
Which assistants does it work with?
Works in ChatGPT or any chatbot: you paste in your details and it writes the result. Python 3 (standard library only). Without a shell, the skill checks a pasted SKILL.md by reading.
For technical users
Using it with an AI assistant
- Run
npx skills add proskillpacks/skillsin your project and pick this skill. Or copy theskill-portability-checkfolder from GitHub (https://github.com/proskillpacks/skills/tree/main/skills/developers/skill-portability-check). - Put the
skill-portability-checkfolder where your assistant looks for skills. The generic path is.agents/skills/(ornpx skills addfrom a folder). Tool-specific paths:- Claude Code:
~/.claude/skills/(or.claude/skills/inside one project) - OpenAI Codex, Gemini CLI, Cursor and others:
.agents/skills/or the skills folder their docs name - claude.ai: zip the skill folder yourself, then Customize, Skills, the plus button, Create skill, Upload a skill (code execution must be on in Settings, Capabilities)
- ChatGPT or any chatbot: open the skill's
prompt.md, paste it into the chat, then paste your own text or link - Steps for each tool, with links to its official docs: how to install skills
- Claude Code:
- Ask for the job in plain words, for example: "Check my skills repo for portability problems.". The skill loads by itself.
Jobs that go with this
- Browse the web with an AI agent in fewer steps (Free): A browsing task in, the task done in fewer steps.
- Check a README works for a first-time user (Free): Your repository in, each setup step marked OK or broken.
- Find accessibility problems on a web page (Free): A page address in, a ranked list of problems with a fix for each.