talk-stage1-extract

Talk Stage 1: Extract

Transforms raw material (article, transcript, notes, or a mix) into a structured summary ready for the pipeline's downstream stages. Auto-detects source type.

When to Use This Skill

• Starting a new talk from any source material
• First step of the talk pipeline (always run before other stages)
• Auditing existing source material before committing to a talk

What This Skill Does

1. Collects metadata by asking for slug, event, date, duration, audience, mode if not provided
2. Reads the source and loads the source file or inline content
3. Detects source type (REX with real-world proof vs Concept with ideas/thesis) based on content signals
4. Extracts the narrative arc (chronological for REX, thematic for Concept)
5. Extracts metrics with every measurable number and its source
6. Identifies main themes (3-7 themes)
7. Flags gaps: what's missing for a complete talk
8. Writes {slug}-summary.md

Input

Required:

• Source file path or inline content (article .mdx, transcript .md, notes)
• Metadata: slug, event, date, duration, audience, type (--rex or --concept)

If metadata is missing -> AskUserQuestion before proceeding.

Output

talks/{YYYY}-{slug}-summary.md

Source Type Detection

REX signals	Concept signals
Specific dates	Theses, arguments
Measured metrics	General observations
Project/tool names	Trend observations
Commits, releases, PRs	Analogies, metaphors
"I shipped", "We built"	"I think", "In my opinion"

If hybrid -> note both components in the summary.

Output Format

# Talk Summary: {Provisional Title}

**Slug** : {slug}
**Event** : {event}
**Date** : {date}
**Duration** : {duration} min
**Audience** : {audience description}
**Type detected** : REX | Concept | Hybrid
**Source** : {source file path}

---

## Narrative Arc

{Arc description: 3-5 sentences. Chronological if REX, thematic if Concept.}

## Main Themes

| # | Theme | Short description | Weight |
|---|-------|------------------|--------|
| 1 | {theme} | {description} | High/Medium/Low |
...

## Key Metrics Extracted

{All measurable numbers found in the source}

Format: `{value}`: {context} (Source: {section/page/git})

Examples:
- `1,200 commits` over 7 months (Source: "acceleration" section)
- `-97% traffic` after SSE migration (Source: CHANGELOG v1.1.0)

If none -> "No verifiable metrics found (Concept mode)"

## Narrative Potential

{3-5 sentences on the strengths and possible narrative angles.
What makes this talk potentially strong. What might be missing.}

## Gaps Identified

- [ ] {gap 1}: {how to fill it}
- [ ] {gap 2}: {how to fill it}

If no obvious gaps -> "No major gaps identified."

## Recommendations for next stages

- **Research**: {recommended / not applicable (Concept mode)}: {why}
- **Concepts**: {priority themes to explore}
- **Position**: {angles already visible from the source material}

---

*Generated by talk-stage1-extract: {date}*
*Source: {source path}*