$npx -y skills add mphinance/alpha-skills --skill docs-pageA documentation page — left nav, scrollable article body, right-rail table of contents. Use when the brief mentions "docs", "documentation", "guide", "API reference", or "tutorial".
| 1 | # Docs Page Skill |
| 2 | |
| 3 | Produce a single, three-column documentation page in one HTML file. |
| 4 | |
| 5 | ## Workflow |
| 6 | |
| 7 | 1. **Read the active DESIGN.md** (injected above). Use the body type token for |
| 8 | prose; the mono token for code; respect line-height and max-width rules. |
| 9 | 2. **Pick a topic** from the brief — the page should look like real docs, not |
| 10 | a generic wireframe. Concrete API names, command examples, plausible |
| 11 | parameters. |
| 12 | 3. **Lay out** three regions: |
| 13 | - **Left nav** (240–280px, sticky): grouped link list, current page bolded |
| 14 | with a left-edge accent stripe. 3–5 groups of 4–8 links. |
| 15 | - **Article body** (max-width ~720px, centered in the middle column): |
| 16 | H1, lede paragraph, H2 sections, code blocks, callout boxes (note / |
| 17 | warning), inline links, lists. |
| 18 | - **Right TOC** (200–240px, sticky): "On this page" with the H2/H3 |
| 19 | anchors, current section highlighted as the user scrolls. |
| 20 | 4. **Write** a single HTML document: |
| 21 | - `<!doctype html>` through `</html>`, all CSS inline. |
| 22 | - CSS Grid for the three columns; sticky positioning for the rails. |
| 23 | - Code blocks: monospace token, soft surface fill, copy-button affordance |
| 24 | (visual only — no JS needed). |
| 25 | - Anchor IDs on every H2/H3 so the TOC links work. |
| 26 | - `data-od-id` on the nav, article, and TOC. |
| 27 | 5. **Prose**: write at least 350 words of believable docs. Include at least |
| 28 | one shell command, one code snippet (5–15 lines), one callout, one table. |
| 29 | 6. **Self-check**: |
| 30 | - Body text wraps at the DS line-length sweet spot (60–75 chars). |
| 31 | - Code uses the DS mono token, not generic `monospace`. |
| 32 | - Accent is restrained — used for active nav item, links, one callout |
| 33 | border. Not on body text. |
| 34 | - Page is readable at 1280w and collapses gracefully below 900w (TOC drops |
| 35 | out, nav becomes a top drawer). |
| 36 | |
| 37 | ## Output contract |
| 38 | |
| 39 | Emit between `<artifact>` tags: |
| 40 | |
| 41 | ``` |
| 42 | <artifact identifier="docs-slug" type="text/html" title="Docs — Page Title"> |
| 43 | <!doctype html> |
| 44 | <html>...</html> |
| 45 | </artifact> |
| 46 | ``` |
| 47 | |
| 48 | One sentence before the artifact, nothing after. |