About

Imported from callstackincubator/agent-skills (.claude/skills/validate-skills/SKILL.md) via skills.sh. Install upstream with npx skills add callstackincubator/agent-skills --skill validate-skills. Copyright stays with the author (MIT).

Validate Skills

Name: validate-skills
Author: callstackincubator

Validate all skills in skills/ against the agentskills.io spec and Claude Code best practices.

Validation Checklist

For each skill directory, verify:

Spec Compliance (agentskills.io)

Check	Rule
`name` format	1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens
`name` matches directory	Directory name must equal `name` field
`description` length	1-1024 characters, non-empty
Optional fields valid	`license`, `metadata`, `compatibility` if present

Best Practices (Claude Code)

Check	Rule
Description format	Third person, describes what + when to use
Body length	Under 500 lines
Loading is one-level deep	`SKILL.md` is the only progressive-disclosure entry point: every reference file must be reachable from `SKILL.md`. References may cross-link each other for navigation (see note below).
Links are markdown	Use `[text](path)` not bare filenames
No redundancy	Don't repeat description in body
Concise	Only add context Claude doesn't already have

One-level-deep vs. cross-linking. The one-level-deep rule targets progressive-disclosure loading chains — a reference that can only be discovered by loading another reference first (SKILL.md → a.md → b.md, where b.md is not linked from SKILL.md). That is a defect: it hides content from the loader.

It does not forbid navigational cross-links. Per AGENTS.md, reference files end with a "Related Skills" footer linking sibling references, and this is required. A cross-link is fine as long as both endpoints are also reachable directly from SKILL.md. Only flag a reference that is reachable exclusively through another reference.

How to Run

Find all skill directories:
```
fd -t d -d 1 . skills/
```
For each skill, read SKILL.md and check against the rules above

Report issues in this format:

## Validation Results

### skills/example-skill
- [PASS] name format valid
- [FAIL] name "example" doesn't match directory "example-skill"
- [PASS] description length OK (156 chars)

References

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/callstackincubator-agent-skills-validate-skills/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

callstackincubator-agent-skills-validate-skills.ocm.jsonjson

{
  "ocm": "1",
  "id": "callstackincubator-agent-skills-validate-skills",
  "kind": "skill",
  "name": "validate-skills",
  "description": "Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command.",
  "publisher": "callstackincubator",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "validation",
      "linting",
      "skill-authoring",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/callstackincubator/agent-skills",
      "path": ".claude/skills/validate-skills/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/callstackincubator/agent-skills/validate-skills",
      "key": "callstackincubator/agent-skills/.claude/skills/validate-skills/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Validate Skills\n\nValidate all skills in `skills/` against the agentskills.io spec and Claude Code best practices.\n\n## Validation Checklist\n\nFor each skill directory, verify:\n\n### Spec Compliance (agentskills.io)\n\n| Check | Rule |\n|-------|------|\n| `name` format | 1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens |\n| `name` matches directory | Directory name must equal `name` field |\n| `description` length | 1-1024 characters, non-empty |\n| Optional fields valid | `license`, `metadata`, `compatibility` if present |\n\n### Best Practices (Claude Code)\n\n| Chec",
  "cost": {
    "context_tokens": 600
  }
}

Fetch it by URL: GET /api/v1/registry/callstackincubator-agent-skills-validate-skills/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.