Problem
Each skill ships a README.md that duplicates the SKILL.md ~100% (when-to-use, when-not-to-use, actions table, invocation, output). Decided during roadmap review 2026-06-18: this is redundant — people will read the SKILL.md.
Scope
- Remove
README.md from skills where it just mirrors SKILL.md.
- The duplication exists because GitHub renders
README.md (not SKILL.md) when browsing a folder.
Option to evaluate (not blocking)
- Symlink
README.md -> SKILL.md per skill so GitHub still renders something on folder browse.
- Caveat: symlinks are fragile across OSes; must not produce an empty file. If it doesn't hold cleanly, drop the README entirely — it's a nice-to-have, not required.
QA
Problem
Each skill ships a
README.mdthat duplicates theSKILL.md~100% (when-to-use, when-not-to-use, actions table, invocation, output). Decided during roadmap review 2026-06-18: this is redundant — people will read the SKILL.md.Scope
README.mdfrom skills where it just mirrorsSKILL.md.README.md(notSKILL.md) when browsing a folder.Option to evaluate (not blocking)
README.md->SKILL.mdper skill so GitHub still renders something on folder browse.QA