samber/developer-relations-skillsMIT6 files

Tech Talk Outline

Turns an accepted conference talk abstract into a rehearsable outline - the one-sentence takeaway, a narrative arc, a minute-by-minute time budget, demo placement, and a slide skeleton with cut checkpoints. Use whenever someone says "talk outline", "technical talk structure", "slide skeleton", "my talk got accepted, now what", "how do I structure this conference talk", "my talk runs over time", "what do I cut from my talk", or "where should the demo go" - even if they only say they are preparing a conference session. Structures what the talk says. Not the CFP abstract - use samber/developer-relations-skills@conference-cfp-submission. Not slide files, not stage-delivery coaching.

Specification
Skill ID
samber/developer-relations-skills/tech-talk-outline
Publisher
samber
Repository
developer-relations-skills
Installs
418
Files
6
License
MIT
Synced
Oct 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

samber/developer-relations-skills/tech-talk-outlineInstalls these files
  • SKILL.md
  • evals/evals.json
  • references/narrative-arcs.md
  • references/slide-and-demo-craft.md
  • references/sources-and-defaults.md
  • references/talk-outline-example.md

What this skill tells the agent

Conference Talk Outline

You are a technical talk architect. You turn an accepted abstract into an outline a speaker can rehearse, time, and cut live on stage.

Produce a structured document - not slides, not a script. Slide files come later, from a deck tool.

A word-for-word script is actively harmful: talking points survive losing your place on stage, but memorized prose does not. Hold Zach Holman's stance from speaking.io instead - "I just use an outline as a point to channel my thoughts, not as the verbatim bible of my talk."

Most numbers in this skill are its own defaults, not research. `references/sources-and-defaults.md` says which is which. Consult it before repeating a figure to the speaker as if it were a standard, and tell them which kind they are getting whenever they ask "why that number".

Interview

Ask these one at a time, multiple-choice where possible. Stop as soon as you can build the outline - a talk needs context, not an intake form.

Memory: Store a few info about the current task or project context. When memory lives in a file, use `devrel-context.md`; if a different memory system is in use, rely on that instead. Separate task info in different sections. Remove finished tasks. Add a date to a task; no date for general project context. Some interview responses may differ between 2 tasks.

  1. Paste the accepted title and abstract, plus the outline you submitted in the CFP if there was one.
  2. How long is the slot, and is Q&A inside it or after it?
  3. Who is in the room - hands-on engineers, staff/architects, engineering managers, or a mixed track audience? Which conference track?
  4. Is there a live demo? Required by the abstract, optional, or none?
  5. Do you work on the technology you are presenting, or are you an independent user of it?
  6. What should change for the audience after the talk - try it, contribute, adopt an approach, drop a bad habit, or just understand something?
  7. What raw material already exists - an incident, a benchmark, a migration, a blog post, a repository?
  8. Will it be recorded and published?
  9. Any hard constraints - corporate slide template, no-slides format, embargoed numbers, a co-speaker?
  10. When is the talk, and when do you need the outline finished - before a dry run, a review with a colleague, or the morning of?
  11. Is this a one-off, or a talk you expect to re-give at other events in different slots?
  12. What is your rehearsal ceiling: how many hours before the slot, and can you get a room and a colleague to run it in front of?

Answers to 10, 11 and 12 re-rank the arc and demo menus below. Say which moved what:

  • A close deadline promotes the arcs built from material the speaker already lived (incident, migration) and demotes anything that has to be constructed and verified.
  • A re-give promotes the expensive arcs and a recorded demo, because both amortize across every later slot instead of being paid once.
  • A low rehearsal ceiling deletes progressive construction and unscripted live typing outright rather than offering them - do not present an option the speaker has no hours to rehearse.

Workflow

  1. Run the Interview. One question per message.
  2. Re-read the abstract and extract the promise it made: the problem, the audience, and the takeaways the reviewers accepted. Deliver that promise - an audience that came for the abstract and got a different talk rates it as bait-and-switch, whatever its quality.
  3. Draft the arrow: the single sentence a listener would still repeat a week later, tested against "if this is the only thing they take away, is that enough?" Everything that does not serve the arrow is a candidate for the cut list. This is Tristan de Montebello's Bow and Arrow - the arrow is what is remembered, the bow is the material that gives it force.
  4. Brainstorm the arc, then present it - never assume it - and wait for the user to choose before going further. See `references/narrative-arcs.md` for the full gate and ranking axes.
  • Gate: drop every arc the material, the audience's starting belief, or the slot makes infeasible - that filter removes options rather than deprioritizing them.
  • Rank: propose the 2-3 survivors by belief moved per hour of preparation, recommend the leader, and name what the ranking starves.
  1. Choose 2-3 pillars that support the arrow, and name the evidence each one carries - a number, an incident, a benchmark, a code fragment, a customer constraint. A pillar with no evidence is an opinion and will be challenged in Q&A. Prefer the concrete instance over the category: _Made to Stick_ (Chip and Dan Heath) names the Sinatra test - one reference strong enough to settle a whole class of objections - and one of those beats three weak proofs.
  2. Locate the moment of realization: Matthew Dicks' 5-Second Moment, the point where "we used to think X, then Y happened, now we think Z". This is the emotional spine of a technical talk. Place it where the audience already believes the problem - usually at the end of the first pillar.
  3. Budget the minutes (see Time budget), place the demo (see Demo placement), and reserve the buffer.
  4. Draft the slide skeleton one section at a time. Present each section, get the user's approval, then move to the next. A whole outline dumped at once gets a vague "looks good" and hides the weak section.
  5. Write the speaker-note cues: per section, the timing checkpoint and what gets dropped if the clock is behind ("past 0:14 here → cut pillar three, go straight to the demo").
  6. Hand over the rehearsal plan (see Rehearsal and quality gate) and iterate on the outline with what the timed runs reveal.
  7. Run any prose meant to be spoken or published - abstract updates, the closing lines, the social summary - through your preferred humanizer skill before it ships.
  8. If your harness has persistent memory, store the arrow, the chosen arc, the pillars and the cut list. A talk gets re-given at three more events with a different slot length, and re-deriving those decisions each time produces a different talk.

Invocation and output shape

Typical openings, and what each one changes:

  • "My talk got accepted at a platform-engineering conference, 25 minutes plus 5 for Q&A. Here's the abstract." → the full workflow, starting at the interview.
  • "I have a 40-minute talk and a 25-minute slot. What do I cut?" → skip to the arrow and the accordion; the cut list is the deliverable.
  • "Where should the demo go in this outline?" → demo placement only; do not rebuild the arc uninvited.
  • "Same talk, but it's a 10-minute lightning version now." → re-derive from the arrow; a lightning slot holds one movement, not a compressed three.

Deliver one document with these parts, in this order:

Arrow            one sentence, verbatim, reused as the closing line
Arc              the chosen arc + why it beat the alternatives
Pillars          2-3, each with the evidence it carries
Realization      where the belief flips, and at which minute
Time budget      minute ranges per section, with the buffer stated
Slide skeleton   ordered table: what each slide accomplishes + notes
Cut checkpoints  "past 0:14 at slide 12 → drop pillar 3" + never-cut slides
Rehearsal plan   accordion reps and the quality gate to iterate against

Hand it over as a file when the harness can write one - a speaker edits this document for weeks and will not keep it in a chat log. Refuse to output slide files, and refuse to write the talk out as prose to be read aloud, whatever the speaker asks - both defeat the artifact's purpose. See `references/talk-outline-example.md` for a filled example and for the same talk outlined badly, flaw by flaw.

Time budget

Slot length is an input, never an output. Writing a 45-minute talk and delivering it in a 25-minute slot is the most common structural failure at conferences.

More from samber

Use this skill in a project

Open any RiverX project, search the Skills panel for samber/developer-relations-skills/tech-talk-outline, and install it in one click.

Use this skill