mcpField
S
skill-validator

skill-validator

github.com/jorgealvesAgent workflows2216 installsUpdated 3d ago
Repository

About skill-validator

A repository quality-control skill that checks AI Agent Skills against the agentskills.io standard and repository AGENTS.md rules. It validates YAML and Markdown contracts, not skill execution or internal logic.

Key features

  1. 01Checks agentskills.io compliance
  2. 02Applies repository AGENTS.md rules
  3. 03Validates skill YAML and Markdown
  4. 04Flags missing or invalid skill definitions
  5. 05Runs locally with read-only access

Use cases

  1. 01Checking a skill during development
  2. 02Blocking non-compliant pull requests in CI
  3. 03Auditing the agent-skills/ directory

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jorgealves/agent_skills --skill skill-validator

After installing, type/skill-validatorin Claude Code to confirm it loaded.

Bundled filesskill.yaml

Details

From the project README

Skill Validator

Purpose and Intent

The skill-validator is the primary quality control tool for this repository. It ensures that every AI Agent Skill is "machine-consumable" by validating it against the agentskills.io standard and the repository's AGENTS.md rules.

When to Use

  • During Development: Run this skill every time you create or modify a skill.
  • CI/CD Integration: Automatically block Pull Requests that contain non-compliant skill definitions.
  • Repository Audits: Periodically scan the entire agent-skills/ directory to ensure long-term compliance as specifications evolve.

When NOT to Use

  • Code Logic Validation: This tool does not "run" the skills or verify their internal logic; it only validates the "contract" (the YAML and Markdown).

Error Conditions and Edge Cases

  • Invalid YAML: If skill.yaml cannot be parsed, the validator will fail immediately with a syntax error.
  • Missing Required Fields: Any missing field defined in the agentskills.io specification will result in is_valid: false.
  • Empty Directories: Folders in agent-skills/ that do not contain a skill.yaml will be flagged as invalid skills.

Security and Data-Handling Considerations

  • ReadOnly Access: The skill only requires read permissions for the target directory.
  • No External Calls: Validation is performed locally using the embedded schema rules.

Comments

Markdown supported