endurance-coach-docs-and-writinglisted

Load when writing, updating, or reviewing any prose/documentation in the Endurance Coach repo, or deciding WHICH doc a change belongs in. Triggers: "update the docs", "which doc owns this", "code and docs move together", "did I update the right doc", writing or editing README.md / HANDOVER.md / CLAUDE.md / CONTRIBUTING.md / SETUP.md / docs/PRODUCT.md / docs/commands.md / docs/data-sources.md / docs/insight-engine.md / docs/mcp-server.md / docs/profile.md / a docs/specs/* spec / a docs/specs/improvements/* fix write-up; "house style", "how do we phrase this", labelling something a MODEL/estimate, showing missing data as "—", formatting a duration as h:mm, spelling out an acronym on first use, a critical-warning blockquote; adding or editing a profile question (which regenerates docs/profile-questions.md — never hand-edit that file); writing a spec skeleton or a HANDOVER-style known-issue entry; making a coaching claim sound honest rather than oversold. Do NOT load for the definition-of-done gate mechanics or t
maxeskell/personal-training-app · ★ 0 · AI & Automation · score 70

Install: claude install-skill maxeskell/personal-training-app

# Endurance Coach — docs and writing **Use this when** you are writing or editing any documentation or user-facing prose in this repo, deciding which doc a change belongs in, matching the house voice, or adding a profile question (which regenerates a doc). **Don't use this when** you need the *rules* about when docs must ship (the definition-of-done gate, green-before-commit, branch-then-ship) — that is `endurance-coach-change-control` — or when you are making a public/competitive/novelty claim about the product — that is `endurance-coach-external-positioning`. The one rule everything here serves: **code and docs move together in the SAME commit.** A behaviour, command, config, card, or schema change that ships without its doc update is an incomplete change, not a follow-up. This is mandated by `CLAUDE.md` (§"Definition of done" #1) and `CONTRIBUTING.md` (§"Definition of done" #1). This skill tells you *which* doc, *what* voice, and *how* — the gate that enforces it lives in `endurance-coach-change-control`. Jargon defined once (used below): **MODEL / estimate** = a computed value that is not a ground-truth measurement (a zone, a split, a road-dryness call, a race prediction); house rule requires it be labelled so. **Source-of-truth** = the doc that is authoritative for a topic; if code and that doc disagree, the doc is the spec and the code is the bug (or vice-versa — reconcile, don't diverge). **h:mm** = hours:minutes duration format (e.g. `1:30`, not `90 min` or `1.5h`)