skills-review-lint

name	skills-review:lint
argument-hint	[--all | <path/to/SKILL.md> ...] [--severity error]
description	Lint SKILL.md files for quality, correctness, and adherence to the skill guidelines. Use when reviewing, creating, or modifying skills.
user-invocable	true
allowed-tools	Bash, Read, Glob, Grep

Skill Linter

Runs the skills quality linter (scripts/lint-skills.py) and presents findings.

Synopsis

/skills-review:lint                                    # Lint changed SKILL.md files (vs main)
/skills-review:lint --all                              # Lint all SKILL.md files
/skills-review:lint plugins/foo/skills/bar/SKILL.md    # Lint specific file(s)
/skills-review:lint --severity error                   # Only show errors, suppress warnings

Steps

1. Parse Arguments

Determine the linting scope from $ARGUMENTS:

Argument	Command	Behavior
(empty)	bash scripts/lint-skills.py	Lint SKILL.md files changed vs main branch
--all	bash scripts/lint-skills.py --check-all-files	Lint every SKILL.md under plugins/
--severity error	bash scripts/lint-skills.py --severity error	Only report errors (E001–E007), skip warnings
file paths	bash scripts/lint-skills.py <paths>	Lint the specified file(s)

Arguments can be combined: --all --severity error or path/SKILL.md --severity error.

2. Run the Linter

Execute from the repository root.

3. Present Results

• If the linter finds no issues, report that all checked skills passed.
• If issues are found, present them grouped by file with check ID, severity, and message.
• For errors (E001–E007), recommend immediate fixes.
• For warnings (W001–W012), suggest improvements but note they are advisory.
• If the user wants to fix issues, propose concrete patches for the failing SKILL.md files.

Examples

User: /skills-review:lint Claude: Runs linter on changed files, reports findings, offers to fix.

User: /skills-review:lint --all Claude: Runs linter on all SKILL.md files across the repo.

User: /skills-review:lint plugins/lvms/skills/setup-prereq/SKILL.md --severity error Claude: Lints the specified file, showing only errors.

Edge Cases

• No SKILL.md files changed: Report that no files matched and suggest --all to lint everything.
• Linter script missing: Warn that scripts/lint-skills.py was not found at the expected path.

Notes

• Analysis-only by default: This skill runs the linter and presents findings. It only modifies files if the user explicitly requests fixes.
• See plugins/docs/SKILL-GUIDELINES.md for the full quality standards reference.
• The linter is a standalone Python script with no external dependencies.