New example skill bundle
Create a valid agentskills.io bundle at examples/skills/<skill-name>/.
Skill: $ARGUMENTS
Rules
- The bundle format is validated by
@skillist/skill-format.SKILL.mdfrontmatter must satisfyskillFrontmatterSchema:name(lowercase-hyphen, ≤64, matching the directory),description(≤1024), optionallicense,compatibility,metadata,allowed-tools. - Allowed structure:
SKILL.mdat root; optionalscripts/,references/,assets/dirs; optionalplugin.json. Nothing else at the root. - Study a sibling for the house style:
examples/skills/api-design/,git-commit/,registry-mcp/,security-audit/,sql-review/,cloudflare-deploy/. Match their tone and structure. - These bundles are fixtures + seed data + eval inputs — keep them realistic and self-contained.
assets/are Biome-ignored.
Steps
- Create
examples/skills/<skill-name>/SKILL.mdwith valid frontmatter and instructions. (createSkillTemplatein@skillist/skill-formatshows the canonical shape.) - Add any
scripts//references//assets/the skill needs. - Validate: run the skill-format tests, or
pnpm clito lint/review the bundle, or the review action. At minimum confirmvalidateSkillBundlepasses.
Verify
pnpm --filter @skillist/skill-format test(fixtures are exercised here).- Optionally
pnpm seed:registry(dev DB) to confirm it seeds, andpnpm run:public-evalsif it should be an eval target. pnpm check.