skill-lint

Audit skill and prompt files for structural and schema issues.

22|2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/WeZZard/skills --skill skill-lint-wezzard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-lint
Source: https://github.com/WeZZard/skills/tree/main/claude/skill-kit/skills/skill-lint
Command: npx skills add https://github.com/WeZZard/skills --skill skill-lint-wezzard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit skill/prompt files for structural issues, step continuity, cross-reference integrity, and JSON schema format coherence. Uses a two-phase approach: automated deterministic checks followed by LLM semantic analysis dispatched to the agent specified by --agent.

Core Features & Use Cases

  • Deterministic checks ensure frontmatter validity, step sequencing, and cross-tool references.
  • Semantic analysis validates consistency and schema conformance via a configurable LLM backend.
  • Useful for validating Claude Code skill definitions before packaging or deployment.

Quick Start

Provide the path to lint and the agent when invoking the tool.

Frequently Asked Questions about skill-lint

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

FAQPage Schema
How do I validate skill and prompt files for structural issues and schema coherence?

To validate skill and prompt files for structural issues and schema coherence, you can use a two-phase approach combining automated deterministic checks for frontmatter validity and step sequencing with LLM semantic analysis for consistency.

What does cross-reference integrity checking involve when auditing prompt files?

Cross-reference integrity checking validates that references between steps and tools within prompt files remain consistent and correctly linked. It ensures that any cross-tool references defined in the skill schema point to valid, existing components.

Can I use an LLM agent to perform semantic analysis on skill definitions?

Yes, you can dispatch semantic analysis to an LLM agent by specifying it with the agent flag. This LLM backend validates consistency and schema conformance that deterministic checks cannot catch.

Do I need to specify a path and an agent to run schema format checks on directories?

Yes, you must provide a target path to process directories or files and specify an agent for semantic checks. The path drives the deterministic file scan while the agent handles the semantic validation phase.

What is the best way to audit Claude Code skill definitions before deployment?

The best way to audit Claude Code skill definitions before deployment is to run a combined deterministic and semantic validation. This verifies frontmatter validity, step continuity, and JSON schema format coherence to ensure packaging readiness.

Why does step continuity validation fail in my prompt file structure?

Step continuity validation fails when the deterministic checker detects gaps or inconsistencies in the step sequencing within your prompt file structure. The audit identifies these structural issues before the LLM semantic analysis phase begins.