opensite-ai/opensite-skills / book-recorded-sessions
book-recorded-sessions
VerifiedPlan, record, and merge recorded sessions into book chapters: solo lessons, interviews with a proxy reader, multi-guest panels, or hybrid lesson-plus-conversation episodes that also serve video and short-form clips. Covers contract-driven run-of-show, contributor releases and employer clearance, per-speaker capture and transcripts, speaker-attributed atoms, merging many sessions into a traceable chapter, and clip hand-off flags. Use when chapters are built from spoken recordings or podcasts. Not for narrating the finished audiobook or editing clips.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
| assets/segment_types.yaml | config | 5.1 KB |
| references/contributor-release.md | markdown | 2.8 KB |
| references/merge-rules.md | markdown | 2.4 KB |
| references/session-formats.md | markdown | 3.8 KB |
| scripts/chapter_trace.pyexecutable | script | 8.1 KB |
| scripts/session_ingest.pyexecutable | script | 9.4 KB |
| scripts/session_plan.pyexecutable | script | 8.1 KB |
references/merge-rules.md
View on GitHub# Merge rules: from sessions to a chapter
Merging means building the chapter the contract describes from the best recorded material across
sessions. It is not cleaning up one transcript.
1. **Spine first.** Lay out the contract's sequence (problem, model, example, exercise,
verification, recap) and fill it with the author's lesson atoms. If a step has no author atom,
record a pickup; do not compose the missing teaching.
2. **Best telling wins.** When the author explained something in several sessions, use the
clearest telling and log the alternates' atom ids in a comment for the editor.
3. **Guests illustrate; they don't carry the argument.** Insert practitioner atoms where they
prove or complicate the author's point:
- Credited quote: "We lost a month," Sam Lee said. Verbatim, cleaned only of fillers and false
starts, meaning unchanged.
- Credited paraphrase: Sam Lee, who runs operations, watched a team lose a month.
- Never first person for someone else's experience, and never a composite person or quote.
4. **Keep real disagreement.** If a guest disagreed, keep it as a named counterpoint and state
the author's position. Don't blend it into a false consensus.
5. **Spoken to written, without losing the voice.** Reorder, complete sentences, and cut
repetition, keeping the author's idiom (`03-manuscript/VOICE_GUIDE.md`). In mode T, any
sentence the agent composes goes inside `{{ai}}...{{/ai}}` for the author to rewrite or dictate.
6. **Trace everything.** End each paragraph with `<!-- src:A-0012 -->` (several ids
comma-separated) in the same paragraph. Builds strip the markers.
7. **Claims and confidentiality.** Add `<!-- claim:C-#### -->` to every factual statement,
whoever said it, and route it to `book-evidence-factcheck`. Remove or clear client names,
deal terms, and internal numbers before the atom enters a chapter.
8. **Quote approval.** Send each guest their credited quotes and paraphrases in context, with the
release's response window. Record approval in the RIGHTS_LEDGER evidence.
9. **Audio-first.** Quotes are read by the narrator; signpost them for listeners ("as Sam put
it") and avoid back-and-forth dialogue on the page.
10. **Check.** Run `chapter_trace.py` (draft), `claims_check.py --mode draft`, and
`atom_coverage.py`. Fix untraced paragraphs, uncredited guest words, and low author share
before G4.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |