skill-creator-playbook

v1.0.0 featured MIT meta updated 2026-09-26

Author, validate, and publish agentskills.io skills — the SKILL.md format, the 5-section README bar, a zero-dependency validator, and the path to listing here.

$ skillbank install skill-creator-playbook@1.0.0
# pins exactly 1.0.0 · README + changelog included

Overview

The fastest way to grow the agent-skills ecosystem is to make publishing trivial. This skill is the playbook: the SKILL.md format from the agentskills.io open specification, the five README sections every quality listing needs, a validator script that checks your package the same way the registry does, and the path to listing it on AI Skill Bank.

Installation

  1. Copy the skill-creator-playbook/ directory anywhere convenient.
  2. Make the validator executable (Unix):

``bash chmod +x scripts/validate-skill.py ``

No dependencies — the validator is standard library only.

Configuration

No configuration. The validator takes a skill directory path and optional flags (see Inputs). The publishing guide lives in references/publishing.md.

Inputs

CommandArgumentsReturns
validate-skill.py <skill-dir>path to skill directoryPASS/FAIL with specific problems, exit 0/1.
validate-skill.py <skill-dir> --strictas aboveAs above, plus warnings for niceties.

The validator enforces the publisher checklist:

  1. SKILL.md exists and starts with --- YAML frontmatter.
  2. name matches ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])$ and equals the directory name.
  3. description is present, non-empty, ≤ 1024 chars.
  4. A license is declared (frontmatter license or LICENSE file).
  5. The body contains all five sections: **overview, installation,

configuration, inputs, worked example**.

  1. CHANGELOG.md exists.

Worked example

$ mkdir -p my-skill/scripts && cd my-skill
$ ../skill-creator-playbook/scripts/validate-skill.py .
FAIL my-skill
  ✗ SKILL.md body is missing a 'worked example' section
  ✗ missing CHANGELOG.md (list every version, newest first)
$ ../skill-creator-playbook/scripts/validate-skill.py .
PASS my-skill

A passing package is ready to submit at https://aiskillbank.com/submit.html — see references/publishing.md for the listing tiers.

Safety notes

The validator only *reads* your skill directory; it never modifies, uploads, or executes anything inside it. Run it as often as you like, including in CI.

Version history

  1. v1.0.02026-09-26
    • Initial public release.
    • validate-skill.py: zero-dependency validator implementing the full publisher checklist (frontmatter, name rules, directory match, description length, license, 5 README sections, CHANGELOG).
    • references/publishing.md: the AI Skill Bank submission → review → publish pipeline and listing tiers.

← back to catalog