Skip to content

opensite-ai/opensite-skills / book-recorded-sessions

book-recorded-sessions

Verified

Plan, 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.

FileKindSize
SKILL.mdskill md4.9 KB
assets/segment_types.yamlconfig5.1 KB
references/contributor-release.mdmarkdown2.8 KB
references/merge-rules.mdmarkdown2.4 KB
references/session-formats.mdmarkdown3.8 KB
scripts/chapter_trace.pyexecutablescript8.1 KB
scripts/session_ingest.pyexecutablescript9.4 KB
scripts/session_plan.pyexecutablescript8.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall