3 Commits
Author SHA1 Message Date
Magnus Hedemark 8e5bc023a0 docs(agent-skills): add third-party skill vetting guidance and deterministic-script rule
Adds references/vetting-third-party-skills.md with a dependency-style
vetting checklist (provenance, SKILL.md body, scripts, references),
safe first-run practice, and reporting guidance, citing the Snyk
ToxicSkills audit as the primary source for ecosystem risk statistics.

SKILL.md gains the match-prescriptiveness-to-fragility decision rule,
the run-vs-reference intent rule for bundled scripts, and an
Adopting Third-Party Skills section. README and eval manifest updated.

Closes #311
2026-08-12 00:44:58 -04:00
Magnus Hedemark 5dfea171cb docs: harden agent-skills reference 2026-07-11 09:07:10 -04:00
Magnus Hedemark 738ec715e7 Add human-focused README.md to every skill and bundle directory
Each README is written for a human audience, explaining:
- What the skill does (not what format it follows)
- What benefit the user gets from installing it
- Quick setup and usage patterns
- When to load/trigger the skill
- What scripts, references, and templates it ships

data-scientist already had a README — left unchanged.

48 READMEs added across all skill and bundle directories.
2026-07-09 22:30:12 -04:00