skills.rest
callstackincubator
callstackincubatorOFFICIAL
Explore all skills by this author →
WebsiteGitHub

validate-skills

Validate skill directories against the agentskills.io specification and Claude Code best practices.

1.6k|115|Updated Jan 14, 2026
Search Tags:#documentation#quality-assurance#validate#lint#skill-authoring#agentskills.io
One-click install
npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-skills
Source: https://github.com/callstackincubator/agent-skills/tree/main/.claude/skills/validate-skills
Command: npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures all skills in the repository comply with the agentskills.io specification and Claude Code best practices, preventing drift and improving quality across skills.

Core Features & Use Cases

  • Spec compliance checks for name formatting, description length, directory-name match, and optional fields.
  • Best practices validation ensures clear usage guidelines, safe prompts, and concise content in SKILL.md.
  • Validation workflow scans each skill directory under skills/, aggregates results, and outputs a structured report for maintainers.

Quick Start

Run the validate-skills command to verify all skills in the repository.

Frequently Asked Questions about validate-skills

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

FAQPage Schema
How do I validate skills against the agentskills.io specification?▼

The validate-skills command scans all skill directories under the skills/ path to check name formatting, description length, and directory-name matches against the agentskills.io specification.

What does skill spec compliance checking include for SKILL.md files?▼

Spec compliance checking inspects SKILL.md files for clear usage guidelines, safe prompts, and concise content to ensure documentation quality aligns with Claude Code best practices.

How do I lint a repository for Claude Code best practices?▼

Lint a repository for Claude Code best practices by running a validation workflow that scans each skill directory under skills/, aggregates the results, and outputs a structured report for maintainers.

Can I get actionable remediation steps when skill validation fails?▼

When skill validation fails, the tool produces a concise, structured validation report that includes actionable remediation steps for maintainers to fix field-level correctness and documentation issues.

Why does skill quality assurance report field-level correctness errors?▼

Skill quality assurance reports field-level correctness errors to prevent specification drift and improve documentation quality across all skills in the repository.

Related Skills

Explore More Software Engineering Skills→
PhyAgentOSPhyAgentOS
1.7k

skill-creator

Scaffold, validate, and package PhyAgentOS Skill units into .skill files.

Community
Advanced
AndreKuraitAndreKurait

aws-cloudformation

Validate AWS CloudFormation templates with cfn-lint and cfn-guard.

Community
Advanced
LinnkidChenLinnkidChen
4

check

Verify changed files against project guidelines using git diff, lint, and typecheck.

Community
Intermediate
ThrookieThrookie
2

plankton-code-quality

Run formatters and linters on every file edit and apply fixes via Claude subprocesses.

Community
Advanced