skill-creator-playbook
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
- Copy the
skill-creator-playbook/directory anywhere convenient. - 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
| Command | Arguments | Returns |
|---|---|---|
validate-skill.py <skill-dir> | path to skill directory | PASS/FAIL with specific problems, exit 0/1. |
validate-skill.py <skill-dir> --strict | as above | As above, plus warnings for niceties. |
The validator enforces the publisher checklist:
SKILL.mdexists and starts with---YAML frontmatter.namematches^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])$and equals the directory name.descriptionis present, non-empty, ≤ 1024 chars.- A license is declared (frontmatter
licenseorLICENSEfile). - The body contains all five sections: **overview, installation,
configuration, inputs, worked example**.
CHANGELOG.mdexists.
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
- 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.