chore: consolidate the skill packages under .agents/

The repository had two skill directories. `skills/` held the four written
for this project; `.agents/skills/` held the ones the agent context refers
to. Nothing said which an agent should read, and `.agents/ORCHESTRATOR.md`
only ever pointed at the second.

Move the first four into `.agents/skills/` so there is one location, and
add the vendored packages this chapter work used: `animation-vocabulary`
and `improve-animations` (emilkowalski/skills), `teach` (mattpocock/skills),
plus a local `translation` skill and `audit-translations.mjs` for the EN/PT
pairs.

`skills-lock.json` pins the vendored three by source and content hash, so a
later re-vendor is a diff rather than a guess. `.claude/skills/` is
symlinks into `.agents/skills/`, which is what makes them loadable here
without a second copy on disk.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Marcos Paulo
2026-09-06 16:03:23 -03:00
parent 61de2f6270
commit ab2308441c
38 changed files with 2662 additions and 122 deletions
+46
View File
@@ -0,0 +1,46 @@
# RESOURCES.md Format
`RESOURCES.md` is the curated set of trusted sources for this topic. Knowledge
for explainers should be drawn from here, not from parametric guesses. Wisdom
comes from the communities listed here.
## Structure
```md
# {Topic} Resources
## Knowledge
- [Book: _The Science and Practice of Strength Training_ by Zatsiorsky & Kraemer](https://example.com)
Foundational text on programming and adaptation. Use for: anything to do with
periodisation, recovery, intensity zones.
- [Article: "How Much Should I Train?" by Greg Nuckols (Stronger By Science)](https://example.com)
Evidence-based review of volume landmarks. Use for: weekly set targets per
muscle group.
## Wisdom (Communities)
- [r/weightroom](https://reddit.com/r/weightroom) High-signal subreddit,
moderated against bro-science. Use for: programme critique, plateau
troubleshooting.
- Local: Tuesday strength class at {gym name} Use for: real-time coaching
feedback on lifts.
```
## Rules
- **High-trust only.** Prefer primary sources, recognised experts, peer-reviewed
work, and communities with strong moderation. If a resource is marketing
dressed as education, leave it out.
- **Annotate every entry.** A bare link is useless in three months. Add one
line: what it covers and when to reach for it.
- **Group by Knowledge / Wisdom.** Mirrors the philosophy in
[SKILL.md](./SKILL.md). It is fine for a resource to appear in only one group.
- **Surface gaps explicitly.** If no good resource exists for an area the
mission needs, write a `## Gaps` section listing what is missing. This drives
future search.
- **Prune ruthlessly.** A resource that turned out to be wrong, shallow, or
off-mission should be removed, not buried. Better five sharp sources than
thirty mediocre ones.
- **Record community preferences.** If the user has opted out of joining
communities, note it here so future sessions don't keep proposing them.