skill-validator-agent — Claude Code subagent for skill checks
skill-validator-agent is a Claude Code subagent that checks skill YAML, structure, file links, and scripts. Run it when creating a skill or reviewing changes.
no license ★ 1,357 updated 2026-03-01
.claude/agents/skill-validator-agent.mdWhat skill-validator-agent does
The subagent inspects a skill’s SKILL.md frontmatter, required fields, directory layout, and content sections. It also reviews the description, document size, and links to other files, helping surface problems before the skill is used.
Its listed tools are Read, Bash, Grep, Glob, and WebFetch. Script checks include python -m py_compile and bash -n; scripts may be executed during validation, so inspect them first. The agent also checks whether a skill loads and responds to an appropriate trigger.
What it helps with
- catch malformed YAML in
SKILL.md - check required sections and skill directory layout
- find broken file and script references
- validate Python and Bash script syntax
- check whether a skill loads and triggers
Example prompts for the agent
- Check my new skill in
.claude/skills/and report structural issues. - Review the YAML and file links in this
SKILL.md, then test its scripts. - Check whether this skill loads and responds to a suitable request.
How to install skill-validator-agent
Manually: put the files in place
.claude/agents/skill-validator-agent.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/skill-validator-agent.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/skill-validator-agent.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about skill-validator-agent
How do I install skill-validator-agent in Claude Code?
Add the agent file at .claude/agents/skill-validator-agent.md.
What does skill-validator-agent do?
It checks skill YAML, layout, links, and scripts, and reviews the description and trigger behavior.
Which script checks does skill-validator-agent use?
It lists python -m py_compile for Python syntax and bash -n for Bash syntax.