Agent Skill Validator

Agent Skill Validator

Validate skill specs for OpenClaw, Claude, Codex, and MCP compatibility. Get portability score, exact fixes, and a patch preview.

Validate first, convert next:SkillSpec Converter

What This Tool Does

Agent Skill Validator is built for deterministic developer and agent workflows.

Validate skill definitions for OpenClaw, Claude, Codex, and MCP compatibility. Detect missing fields, ambiguous triggers, unsafe instructions, and portability breaks with exact fixes.

Use How to Use for execution steps and FAQ for constraints, policies, and edge cases.

Last updated:

This tool is provided as-is for convenience. Output should be verified before use in any production or critical context.

Agent Invocation

Best Path For Builders

Browser workflow

Runs instantly in the browser with private local processing and copy/export-ready output.

Browser Workflow

This tool is optimized for instant in-browser execution with local data handling. Run it here and copy/export the output directly.

/agent-skill-validator/

For automation planning, fetch the canonical contract at /api/tool/agent-skill-validator.json.

How to Use Agent Skill Validator

  1. 1

    Paste your skill definition

    Add your skill spec in JSON, YAML, or markdown. Include name, description, trigger, instructions, and tools for the best validation coverage.

  2. 2

    Select target runtimes

    Choose OpenClaw, Claude, Codex, and/or MCP. The validator applies runtime-specific lint rules and portability checks per target.

  3. 3

    Review errors and warnings

    Inspect diagnostics sorted by severity. High-severity errors indicate portability blockers, while warnings highlight clarity and compatibility risks.

  4. 4

    Apply suggested fixes

    Use the Suggested Fixes tab to address missing fields, ambiguous triggers, naming mismatches, and schema gaps quickly.

  5. 5

    Copy the patch preview and revalidate

    Copy the generated patch preview, apply the changes to your canonical skill, then run validation again until portability score is acceptable.

Frequently Asked Questions

What does Agent Skill Validator check?
It validates skill definitions for cross-runtime compatibility across OpenClaw, Claude, Codex, and MCP. Checks include required fields, trigger clarity, instruction quality, safety risks, naming conventions, and MCP schema readiness.
Which input formats are supported?
You can paste skill definitions as JSON, YAML, or markdown-style skill docs. The validator normalizes structure and runs deterministic lint rules client-side in your browser.
Does Agent Skill Validator execute my tools or prompts?
No. It performs static text analysis only. No tool execution, no remote calls, and no server-side processing of your skill content.
What is the portability score?
The portability score (0-100) summarizes how safely your skill can be reused across selected runtimes. High-severity issues reduce score more than medium or low warnings.
Can I apply fixes automatically?
The tool provides a patch preview with suggested normalized fields and safer defaults. Copy that patch, apply it to your canonical skill file, and revalidate.