Rewrote the skill authoring factory skill from scratch against the agentskills.io specification. Renamed write-skill → skill-write (name now matches directory per spec). skill-write: - Full scaffold via new-skill.sh (annotated templates for SKILL.md, README.md, scripts/, references/, assets/) - validate.sh checks all spec constraints deterministically (name format/length, description length, placeholder detection, line count, script rules) - SKILL.md body includes description rules, body discipline, patterns, and scripts guidance with "why" rationale throughout - Templates usable standalone by agents and humans skill-audit: - Structural validation (via validate.sh) + seven qualitative dimensions - Produces PASS/FAIL/SUGGESTION punch list with per-FAIL fix proposals - Report-only: does not apply fixes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
749 B
749 B
assets/
Static resources bundled with this skill: templates, schemas, lookup tables, sample data, images.
When to add an asset
Add a file here when the skill needs a static resource that:
- Would be tedious to reproduce in instructions (a full JSON schema, a CSV lookup table, a binary template)
- Needs to be referenced by path rather than inlined in SKILL.md
How to reference from SKILL.md
Use a relative path from the skill root:
Use the schema at `assets/response-schema.json` to validate output.
Or instruct the agent to load it conditionally:
If validating output format, use `assets/response-schema.json`.
If no assets are needed
Delete this README and the assets/ directory entirely.