- Home
- Skills
- Prompt & Skill Engineering
- Skill Portability Check
Works with the AI Agents you already use
Skill Portability Check
Checks Agent Skills (SKILL.md folders) for portability and common mistakes with a standard-library Python script, then explains each....
Free
Skill Portability Check
Example session with this skill installed
Check my skills repo for portability problems.
- Read your context and instructions
- Compiled the portability check
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 (skill 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
Connects securely to your tools. The creator never sees your data.
About this skill
Checks Agent Skills (SKILL.md folders) for portability and common mistakes with a standard-library Python script, then explains each finding and the fix. It catches frontmatter that strict YAML parsers reject (such as an unquoted colon in the description, which makes tools like npx skills skip the skill), keys other than name and description, bad name format, a description that does not say when to use the skill, vendor tool names and paths, missing fallbacks when a tool or the network is absent, long bodies, and broken links. Use when the user says "check my skill", "lint SKILL.md", "is this skill portable", "why is my skill not found", "validate my skills repo", or points at a skill folder or a repository of skills.
Free and open source (MIT). Source and README: https://github.com/proskillpacks/skills/tree/main/skills/developers/skill-portability-check All our free skills: https://github.com/proskillpacks/skills . More from Pro Skill Packs: https://proskillpacks.github.io
Every skill in the folder ships with prompt.md, a paste-in version for chatbots that cannot load skills.
Requires Python 3 for script execution. Does not validate runtime logic or trigger reliability. Only checks files within the provided folder.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
This skill has been used 3 times.
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts