1. Habit
  2. Skills
  3. Validate Skills skill
callstackincubator · 7K installs

Validate Skills skill
Runs by itself, PR touches skills folder.

Every skill passes the spec.

Install the Validate Skills skill and make it a habit: follow https://gethabit.dev/skills/callstackincubator/validate-skills.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

7K installs2K starsMIT licenceSource on GitHub ↗

Validate Skills

by callstackincubator · 7K installs

The skill

The validate skills skill checks every skill in a repo against the agentskills.io spec and Claude Code best practices, then reports PASS or FAIL per rule.

Only when you ask.

The habit

Every skill passes the spec.

↻ Runs by itselfPR touches skills folder

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

PR touches skills folder. Runs in GitHub Actions or Claude Code routine.

  • ↻ PR touches skills folder
  • pull_request paths: skills/**

02

It checks its work

all checks PASS. If a check fails, it tells you.

  • ✓name field matches the directory name
  • ✓description is 1 to 1024 characters
  • ✓SKILL.md body is under 500 lines
  • ✓every reference file is linked from SKILL.md

03

It remembers

last validation results. The next run reads it first: skills that failed last time.

loops/validate-skills-loop/results.md

One run, step by step.
Then it stops.

Stop ruleStops after all skill folders in skills/ are checked once per run.

  1. 01

    Find skill folders

    Your agent lists every skill directory with fd -t d -d 1 . skills/.

  2. 02

    Check the spec

    For each SKILL.md it checks name format, name match, description length and optional fields.

  3. 03

    Check best practices

    It checks third-person description, body length, markdown links, no repeat of the description and one-level-deep loading.

  4. 04

    Report results

    It writes a Validation Results list with PASS or FAIL per check.

  5. 05

    Save the log

    It stores the results so the next run can compare.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Validate Skills skill helps.

Use it when

  • ✓ You maintain a skills repo
  • ✓ You add or rename a skill
  • ✓ You want to lint SKILL.md files

Skip it when

  • – You have no skills/ folder
  • – You need to test what a skill does, not its format

Questions

Validate Skills skill, answered.

What does one-level-deep mean?

Every reference file must be reachable straight from SKILL.md. Cross-links between references are fine as long as both are also linked from SKILL.md.

Does it fix problems?

No. It reports PASS or FAIL for each check so you can fix them.

Which rules does it use?

The agentskills.io spec plus Claude Code best practices for skills.

How do I install the Validate Skills skill?

Copy the prompt at the top into your agent. It installs the skill from callstackincubator/agent-skills and sets up the habit. Or run npx skills add callstackincubator/agent-skills --skill validate-skills.

Is the Validate Skills skill free?

Yes. It is published under MIT. Habit is free too.

Validate Skills. Now as a habit.

Install the Validate Skills skill and make it a habit: follow https://gethabit.dev/skills/callstackincubator/validate-skills.md

  • Free
  • No account
  • Undo in one line

All callstackincubator skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by callstackincubator, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.