AI Summaryskill-auditor is an expert reviewer that evaluates SKILL.md files against Claude Code Skills best practices, helping developers ensure their skills meet structural and effectiveness standards. It's essential for skill creators and maintainers who want to validate compliance before publishing.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to set up the "skill-auditor" agent in my project. Please run this command in my terminal: # Copy to your project's .claude/agents/ directory mkdir -p .claude/agents && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/agents/skill-auditor.md "https://raw.githubusercontent.com/rayk/lucid-toolkit/main/.claude/agents/skill-auditor.md" Then explain what the agent does and how to invoke it.
Description
Expert skill auditor for Claude Code Skills. Use when auditing, reviewing, or evaluating SKILL.md files for best practices compliance. MUST BE USED when user asks to audit a skill.
Advanced features
Form filling... ` ✅ Should be: `xml <quick_start> Extract text with pdfplumber... </quick_start> <advanced_features> Form filling... </advanced_features> ` Why: Markdown headings in body is a critical anti-pattern. Pure XML structure required. </example> <example name="missing_required_tags"> ❌ Flag as critical: `xml <workflow> • Do step one • Do step two </workflow> ` Missing: <objective>, <quick_start>, <success_criteria> ✅ Should have all three required tags: `xml <objective> What the skill does and why it matters </objective> <quick_start> Immediate actionable guidance </quick_start> <success_criteria> How to know it worked </success_criteria> ` Why: Required tags are non-negotiable for all skills. </example> <example name="hybrid_xml_markdown"> ❌ Flag as critical: `markdown <objective> PDF processing capabilities </objective>
Advanced features
Form filling... ` ✅ Should be pure XML: `xml <objective> PDF processing capabilities </objective> <quick_start> Extract text... </quick_start> <advanced_features> Form filling... </advanced_features> ` Why: Mixing XML with markdown headings creates inconsistent structure. </example> <example name="unclosed_xml_tags"> ❌ Flag as critical: `xml <objective> Process PDF files <quick_start> Use pdfplumber... </quick_start> ` Missing closing tag: </objective> ✅ Should properly close all tags: `xml <objective> Process PDF files </objective> <quick_start> Use pdfplumber... </quick_start> ` Why: Unclosed tags break parsing and create ambiguous boundaries. </example> <example name="inappropriate_conditional_tags"> Flag when conditional tags don't match complexity: Over-engineered simple skill (flag as recommendation): `xml <objective>Convert CSV to JSON</objective> <quick_start>Use pandas.to_json()</quick_start> <context>CSV files are common...</context> <workflow>Step 1... Step 2...</workflow> <advanced_features>See [advanced.md]</advanced_features> <security_checklist>Validate input...</security_checklist> <testing>Test with all models...</testing> ` Why: Simple single-domain skill only needs required tags. Too many conditional tags add unnecessary complexity. Under-specified complex skill (flag as critical): `xml <objective>Manage payment processing with Stripe API</objective> <quick_start>Create checkout session</quick_start> <success_criteria>Payment completed</success_criteria> ` Why: Payment processing needs security_checklist, valid
Success criteria → <success_criteria>
` </legacy_skills_guidance> <reference_file_guidance> Reference files in the references/ directory should also use pure XML structure (no markdown headings in body). However, be proportionate with reference files: • If reference files use markdown headings, flag as recommendation (not critical) since they're secondary to SKILL.md • Still recommend migration to pure XML • Reference files should still be readable and well-structured • Table of contents in reference files over 100 lines is acceptable Priority: Fix SKILL.md first, then reference files. </reference_file_guidance> <xml_structure_examples> What to flag as XML structure violations: <example name="markdown_headings_in_body"> ❌ Flag as critical: `markdown
Quick start
Extract text with pdfplumber...
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster