Skill Linter

Analyze and validate SKILL.md files for best practices, common issues, and improvement suggestions. Use when reviewing a Skill, creating a new Skill, or when...

This skill appears to implement a legitimate SKILL.md linter, but review these before installing: - The registry claims 'instruction-only' yet includes a Python script (skill_linter.py). Inspect the full script yourself (it appears to only parse and print reports) and confirm you trust the author. - The package does not declare runtime dependencies. Ensure your environment has Python 3 and the PyYAML package (the code imports 'yaml') before running. - The SKILL.md frontmatter lists allowed-tools: Read, Edit, Write. The linter reads the SKILL.md you point it at — avoid passing paths to sensitive files. Confirm whether the skill will ever be allowed to perform writes on your system; if you do not want it to modify files, restrict its permissions or run it in a sandbox. - Because this is an included script (not a vetted install), prefer running it in an isolated environment (container or temporary VM) if you are unsure. If you plan to install for regular use, ask the owner to: 1) Update registry metadata to declare this is a code-backed skill (not instruction-only); 2) Add explicit dependency declarations (python, PyYAML) or provide an install spec; 3) Clarify whether the skill will write changes and whether allowed-tools: Write is required. These changes will remove the remaining incoherence and raise confidence.