|
| 1 | +--- |
| 2 | +name: apod-to-short |
| 3 | +description: "Turn a NASA Astronomy Picture of the Day (APOD) into a 30–60s vertical short — script, shot list, captions, and a rights line. Use when the user mentions APOD, 'astronomy picture of the day', or wants a daily space short/reel/TikTok from a NASA image." |
| 4 | +version: 0.1.0 |
| 5 | +domain: cosmos |
| 6 | +tags: [nasa, apod, video, short, social] |
| 7 | +--- |
| 8 | + |
| 9 | +# APOD → Short |
| 10 | + |
| 11 | +> NASA Astronomy Picture of the Day → a ready-to-shoot 30–60s vertical short. |
| 12 | +
|
| 13 | +## Purpose |
| 14 | + |
| 15 | +NASA publishes a stunning image with an expert explanation every day. This skill |
| 16 | +converts one APOD entry into a complete vertical short package: a hook, a tight |
| 17 | +narration script, an on-screen caption track, a shot/animation list, and a |
| 18 | +rights line — so a creator can film/edit in one sitting without misstating the |
| 19 | +science or the licensing. |
| 20 | + |
| 21 | +## When it fires |
| 22 | + |
| 23 | +- Keyword triggers: `apod`, `astronomy picture of the day`, `daily space short`, |
| 24 | + `nasa image short`, `space reel` |
| 25 | +- File triggers: `apod.json`, `apod-*.md` |
| 26 | +- Command triggers: `/apod-to-short` |
| 27 | + |
| 28 | +## Inputs |
| 29 | + |
| 30 | +| Input | Required | Notes | |
| 31 | +|-------|----------|-------| |
| 32 | +| `apod` | yes | APOD URL/date, or the title + explanation text + image credit. | |
| 33 | +| `length` | no | Target seconds, default `45` (range 30–60). | |
| 34 | +| `voice` | no | `starlight` (default), `arcanea`, or `frankx` — see brand skills. | |
| 35 | + |
| 36 | +## Workflow |
| 37 | + |
| 38 | +1. **Resolve the APOD** — get title, date, explanation, media URL, and the exact |
| 39 | + image credit. If credit names a non-NASA party (ESA, an observatory, an |
| 40 | + individual), flag it for the rights step. ✅ Check: you have a verbatim credit |
| 41 | + string. |
| 42 | +2. **Extract the one idea** — reduce the explanation to a single, true, |
| 43 | + surprising fact a non-expert can grasp. ✅ Check: it survives "what does that |
| 44 | + mean specifically?" |
| 45 | +3. **Write the hook (0–3s)** — a question or claim that earns the first three |
| 46 | + seconds without clickbaiting the science. |
| 47 | +4. **Script the body** — narration timed to `length` at ~2.5 words/sec. Keep |
| 48 | + every claim traceable to the explanation; never invent figures. |
| 49 | +5. **Build the caption track** — short on-screen lines synced to beats (≤7 words |
| 50 | + each). |
| 51 | +6. **Write the shot list** — Ken Burns push/pan on the still, plus any overlay |
| 52 | + labels (object name, distance, instrument). No fabricated footage. |
| 53 | +7. **Emit the rights line** — exact attribution; route through |
| 54 | + [`rights-check-nasa-esa`](../rights-check-nasa-esa) if credit is non-NASA. |
| 55 | + |
| 56 | +## Output contract |
| 57 | + |
| 58 | +```json |
| 59 | +{ |
| 60 | + "title": "string — APOD title", |
| 61 | + "hook": "string — 0–3s opener", |
| 62 | + "script": "string — full narration, timed", |
| 63 | + "captions": ["string — ≤7 words each"], |
| 64 | + "shot_list": ["string — shot/animation directions"], |
| 65 | + "rights_line": "string — exact attribution", |
| 66 | + "duration_sec": "number" |
| 67 | +} |
| 68 | +``` |
| 69 | + |
| 70 | +## Tools & MCP |
| 71 | + |
| 72 | +- Tools: `WebFetch` (resolve APOD), `Read`. |
| 73 | +- MCP dependencies: none required. (Optional: a NASA-media MCP from |
| 74 | + `starlight-mcp` to fetch APOD JSON directly.) |
| 75 | + |
| 76 | +## Quality bar |
| 77 | + |
| 78 | +- [ ] Every stated fact is traceable to the APOD explanation — no invented numbers. |
| 79 | +- [ ] Rights line is verbatim and correct; non-NASA credit is flagged. |
| 80 | +- [ ] Narration fits `length` at ~2.5 words/sec. |
| 81 | +- [ ] Hook respects the audience's intelligence (no "scientists HATE this"). |
| 82 | + |
| 83 | +## Example |
| 84 | + |
| 85 | +See [`examples/example-01.md`](examples/example-01.md). |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +Built on SIP — Starlight Intelligence Protocol |
| 90 | +Substrate: starlightintelligence.org/protocol v1.1.0 |
| 91 | +Layers used: [file-contract, attestation, sovereignty] |
| 92 | +Vertical: starlight-agent-skills · portable capability layer |
0 commit comments