skill-writer

Author, validate and repair Agent Skills so they actually load. AUTO-INVOKE whenever creating, editing or debugging a skill or SKILL.md file, when porting skill scripts to Python, or when a skill that exists on disk never appears in an agent's context. Malformed skills fail silently: an over-long description, a name that does not match its directory, a BOM or unparseable YAML frontmatter each make the runtime skip the skill with no error in any log. Scaffolds new skills from a compliant template, lints frontmatter against the agentskills.io specification — load-blocking errors kept separate from conventions — and drives description-compression repairs that preserve trigger coverage. Enforces Python as the only source language and the shared _lib/skillkit package, flagging leftover shell scripts, missing shebangs or exec bits and non-portable shell-outs. Use when writing or fixing a SKILL.md; for AGENTS.md use agents-md.