AI Tooling · Skill publication checks
Agent Skill Quality Gate
Run deterministic checks on SKILL.md files for structure, clarity, duplication and basic safety heuristics.
AI AgentsSKILL.mdCIWhy it matters
The problem
As a library of AI agent skills grows, incomplete specifications and duplicated or suspicious instructions become harder to review consistently.
How it works
The approach
A Python standard-library CLI scans SKILL.md directories, applies its documented rules and emits scores and CI-friendly findings.
What it includes
- Structural and clarity rules
- Basic shell-risk heuristics
- Duplicate-scope signals
- Markdown and JSON output
Try the tool
Quick start
Commands adapted from the project's documented README. Run from the repository root after cloning it; consult the full README for prerequisites and platform-specific setup.
git clone https://github.com/migmcc/agent-skill-quality-gate.git
cd agent-skill-quality-gate
python -m pip install -e .
skillgate scan ./examples --report reports/report.md --json reports/report.jsonScope and trust
Important limitations
Security findings are heuristic and not a security guarantee. The tool does not execute scanned instructions. The README identifies v0.1 as alpha.