Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/skill-validator-agent.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for Testing and QA →

From the same set112

The whole set →
audit-clean-arch audit-clean-arch audits a Rust codebase against Clean Architecture rules. It locates improper layer dependencies, framework leaks, and concrete adapter couplings. CX Codex +1 ★ 1,357repo stars suggest-refactor The suggest-refactor command reviews Rust code for clean-architecture violations and returns ranked refactoring steps with code examples. CX Codex +1 ★ 1,357repo stars simulation_examples simulation_examples — a set of ready prompts for the simulation commands in Claude: how to frame a decision, a market response or a timeline before you commit to it. CX Codex +1 ★ 1,357repo stars azure-devops-specialist azure-devops-specialist configures Microsoft Azure services and sets up CI/CD automation using the Azure CLI and MCP tools. Helpful when building pipelines and managing cloud deployments. CX Codex ★ 1,357repo stars skill-documenter-agent skill-documenter-agent — a subagent that writes complete documentation for Claude Code skills: SKILL.md, examples, API reference, and usage guides. Works directly with code and text. CX Codex ★ 1,357repo stars parallel-feature-build parallel-feature-build splits complex engineering tasks into dependency-ordered batches and delegates them to parallel agents across isolated Git branches. CX Codex +1 ★ 1,357repo stars agent-organizer The agent-organizer subagent studies a project, chooses specialist agents, and plans their work. Use it when a task needs structured multi-agent coordination. CX Codex ★ 1,357repo stars gsap-animation gsap-animation — a GSAP reference skill covering tweens, timelines, ScrollTrigger and other plugins, so the agent writes animations against the library's current syntax. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open