SkillsAdd

joaquimscosta/arkhe-claude-plugins

skill-validator

Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories).

First seen Jan 26, 2026

Installation

$ npx skills add joaquimscosta/arkhe-claude-plugins --skill skill-validator
View on skills.sh ↗ GitHub repository ↗

Summary

  • Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories).
  • Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from joaquimscosta/arkhe-claude-plugins · top by installs.

npx skills add joaquimscosta/arkhe-claude-plugins
domain-driven-design 31 generating-changelog 24 code-explanation 23 deep-research 19 workflow-orchestration 19 generating-stitch-screens 19 scripting-bash 19 flyway-consolidate 18 managing-adrs 17 listing-stale-branches 17

Browse all from joaquimscosta/arkhe-claude-plugins

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 21
License LICENSE
Default branch main
Open issues 2
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,939 B
  • docs SUMMARY.md 399 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 33 installs

SKILL.md

Skill Validator

Run automated checks against 62 rules covering frontmatter, structure, content, files, references, security, hooks, and MCP.

Quick Start

scripts/validate_skill.py /path/to/skill-directory

With severity filter:

scripts/validate_skill.py /path/to/skill --min-severity warning

Validation Categories

Category Rules Checks
Frontmatter FM001-FM018 Required fields, naming, description, context/agent, maxTurns, memory, disable-model-invocation
Structure SS001-SS006 Line limits, progressive disclosure
Content CW001-CW009 Writing style, terminology, string substitution, dynamic context injection, ultrathink
Files FO001-FO007 Naming conventions, forbidden files
References RI001-RI003 Broken links, orphan files
Security SC001-SC005 eval/exec, undocumented constants
Hooks HK001-HK003 Hook structure, handler format, matcher format
MCP MC001 MCP server configuration format

Severity Levels

Level Action
CRITICAL Must fix before publishing
ERROR Should fix
WARNING Consider fixing
SUGGESTION Optional improvement

Output Example

=== Skill Validation Report: my-skill ===

Summary: 0 critical, 1 error, 2 warnings, 1 suggestion

[ERROR] SS002: SKILL.md exceeds 500 lines (523 lines)
  Location: SKILL.md
  Fix: Split content into WORKFLOW.md, EXAMPLES.md, TROUBLESHOOTING.md

[WARNING] CW001: Second-person language detected
  Location: SKILL.md:45
  Found: "You should create..."
  Fix: Use imperative: "Create..."

Command Options

--min-severity {critical,error,warning,suggestion}  # Filter output
--format {text,json}                                # Output format
--ignore RULE1,RULE2                                # Skip specific rules

Common Issues

"False positive on second-person"

  • Context-appropriate "you" may be acceptable
  • Use --ignore CW001 to suppress

"Script security warning"

  • Add inline comment: # skill-validator: ignore SC001

"Hook/MCP validation incomplete"

  • Install PyYAML for full nested structure validation: pip install pyyaml

See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for complete issue handling.

References

  • [EXAMPLES.md](EXAMPLES.md) - Real validation outputs
  • [references/RULESREFERENCE.md](references/RULESREFERENCE.md) - Complete rules documentation