talk-refine

Reconciles cross-artifact coherence across a finished talk's brief, slides, delivery plan, style spec, and built deck.

1|Updated Nov 25, 2021
One-click install
npx skills add https://github.com/rstagi/dotfile --skill talk-refine-rstagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: talk-refine
Source: https://github.com/rstagi/dotfile/tree/main/.claude/skills/talk-refine
Command: npx skills add https://github.com/rstagi/dotfile --skill talk-refine-rstagi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a talk is built across multiple stages (content brief, slides-content, delivery plan, style spec, and the rendered deck), the artifacts often drift apart — titles mutate, numbers change, cue cards point at the wrong slides, and the deck's colors diverge from the approved palette. This Skill performs the final holistic coherence pass that catches drift hiding at the seams between artifacts. ## Core Features & Use Cases - Spine-survival verification: Traces the throughline, memorable moment, and named specifics verbatim from the content brief through every downstream artifact and the rendered deck. - Cross-artifact consistency checks: Triple-matches assertion titles across slides-content, the built deck, and delivery cue cards; verifies slide counts, speaker notes, and shipped CSS tokens against the style spec. - Holistic anti-slop gates: Re-runs all Keep-It-Human gates A–E across the finished set, applying the accumulation rule (3+ flags routes back to the owning stage). - Reconciliation changelog: Fixes trivial incoherences in place, asks before non-trivial changes, routes structural problems back to the owning sub-skill, and writes 05-refine-notes.md with residual human-only TODOs. - Use Case: Your React slide deck is built and you ask "is this ready to ship?" — the Skill loads all five artifacts, finds that a cue card is keyed to the wrong slide and a chart number drifted from the brief, fixes the trivial issues, and produces a ship-readiness report. ## Quick Start Ask the assistant to run a final coherence pass on your finished talk in ~/talks/<slug> and reconcile the deck against the brief, slides, delivery plan, and style spec.

Frequently Asked Questions about talk-refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check that my slide deck matches my speaker notes and outline?

Run a final coherence pass that loads the content brief, slides-content, delivery plan, style spec, and built deck together. It triple-matches assertion titles across the spec, rendered deck, and cue cards, then verifies slide counts and speaker notes per slide.

What does the talk-refine skill actually fix versus flag?

It fixes trivial drift in place, such as punctuation differences, mis-keyed cue cards, or hex typos. It asks before non-trivial changes like rewording titles or editing the deck, and routes structural problems like a diverged throughline back to the owning sub-skill.

When should I not run a final refinement pass on a talk?

Do not run it on a half-built talk. If the content brief, slides-content, delivery plan, style spec, or built deck is missing, the skill stops and names the stage to run first, since there is no complete set to reconcile.

Does talk-refine fact-check claims or attack my presentation?

No. Refine assumes good faith and checks that artifacts agree with each other; it does not hunt false claims or unsourced numbers adversarially. That red-team audit is the separate talk-roast skill.

Can talk-refine verify an exported PDF version of my deck?

Yes, conditionally. If a deck.pdf was produced via the fallback export path, it checks page count against slide count, confirms fonts are embedded with pdffonts, and verifies selectable text with pdftotext. A rasterized or broken PDF is routed back to the build stage.