ref-sp-agents-skills-authoringlisted

# Skills Authoring ## Purpose Ensure project skills are discoverable, activation-worthy, operationally useful, and maintainable across skills-compatible agents. ## When to use this skill - Creating a new skill file. - Reviewing or updating an existing skill. - Evaluating whether a skill is well-structured. - Adapting a copied skill so it matches this repository instead of preserving stale source-project details. ## Scope And Relationship To The Sharing Spec This skill owns **how to make a good skill in general, from the agent's perspective**: boundary, description/trigger quality, instruction design, progressive disclosure, structure, and evaluation. That guidance applies to any repository that uses skills, not just the one it currently lives in. It does **not** own a sharing spec. If a repo standardizes how a skill is **named** (owner-prefix / domain / template / topic grammar), **assigned a domain** (a domain registry and tags), given **visibility** (repo-local / organization / public), declares **hard vs soft dependencies**, and is **vendored or forked**, that belongs in a separate sharing-spec skill. In this repo that skill is `ref-sp-agents-shareable-skills`. Skill quality and sharing policy are **complementary but independent**, and neither hard-depends on the other. You can author an excellent skill that is deliberately `repo-local` and never touches any sharing spec, and you can share a skill whose general quality is reviewed here. Consult the sharing spec (a