skill-scanner

Audit SKILL.md files for prompt injection, scope drift, and description alignment.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/tonyandrewmeyer/cantrip --skill skill-scanner-tonyandrewmeyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-scanner
Source: https://github.com/tonyandrewmeyer/cantrip/tree/main/src/cantrip/skills/skill-scanner
Command: npx skills add https://github.com/tonyandrewmeyer/cantrip --skill skill-scanner-tonyandrewmeyer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit SKILL.md files for prompt injection, scope drift, and description alignment to enforce safe agent context.

Core Features & Use Cases

  • Detection of prompt-injection phrases and unscoped authority.
  • Frontmatter and body consistency checks to prevent description drift.
  • CI-ready findings report to gate skill integration.

Quick Start

Run the skill-scanner against a target SKILL.md and review its findings.

Frequently Asked Questions about skill-scanner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit SKILL.md files for prompt injection and scope drift?

To audit SKILL.md files for prompt injection and scope drift, run a scanner against the target files to detect injection phrases, frontmatter validity, and body length inconsistencies. It returns structured findings with severity and actionable fixes for review.

What is description drift in agent context and how is it detected?

Description drift in agent context occurs when SKILL.md body content diverges from its frontmatter scope. It is detected through consistency checks that validate frontmatter fields against the body text, preventing unscoped authority and misaligned agent instructions.

Can I use a SKILL.md scanner as a CI quality gate for skill integration?

Yes, you can use a SKILL.md scanner as a CI quality gate. It generates a CI-ready findings report containing severity levels, evidence, and actionable fixes to guide skill merging decisions and enforce safe agent context during integration.

How do I validate yaml frontmatter in skill documentation?

Yaml frontmatter validation in skill documentation is performed by scanning the SKILL.md file structure. The scanner checks for missing sections, verifies frontmatter field consistency against the body content, and reports findings on structural validity to ensure proper documentation.

What are the limitations of automated prompt-injection detection in skill files?

Automated prompt-injection detection in skill files relies on identifying known injection phrases and unscoped authority patterns. Limitations include potential false positives from legitimate instructional text and the inability to detect novel or highly obfuscated injection vectors outside predefined detection rules.