observed-failure-skill-authoring

Guides writing or revising a skill by evidence - first watch agents fail without it, then write the smallest text that fixes what was observed, re-test, and close the loopholes found - plus discoverability (description wording, keywords, naming, token budget), layout, persuasive-language choices and a release checklist. Use when drafting a skill from real experience, editing a skill, or confirming a skill truly changes agent behavior before it ships. Not for mechanical folder scaffolding or frontmatter linting, and not for project-specific notes that belong in a repo's own instruction file.

Version

v1.0.0

Size

22 KB

Updated

2026-10-02

Your client verifies the signature before reading. This explicit manual read is available on every plan. Free automatically loads five chosen skills; paid plans automatically load relevant skills across the library.