Talk Stage 3: Concepts
Builds an exhaustive catalogue of all identifiable concepts in the source material. Each concept is numbered, categorized, and scored for its talk potential.
When to Use This Skill
- After Stage 1 (and Stage 2 if REX mode)
- Before Stage 4 (Position needs the concept catalogue)
- When you want a structured inventory of what's available before choosing an angle
What This Skill Does
- Reads the summary: loads
{slug}-summary.md
- Reads the timeline (if available): enriches scoring with verified dates
- Extracts concepts: full scan of the source material
- Categorizes: assigns each concept to a domain category
- Scores: HIGH / MEDIUM / LOW for talk potential
- Optional repo enrichment: if repo_path is provided, analyzes AI config concepts
- Writes output files
Input
talks/{YYYY}-{slug}-summary.md (required)
talks/{YYYY}-{slug}-timeline.md (optional, enriches REX concepts)
repo_path (optional, for config/infrastructure concept extraction)
Output
talks/{YYYY}-{slug}-concepts.md (main catalogue)
talks/{YYYY}-{slug}-concepts-enriched.md (if repo_path provided)
Scoring Criteria
HIGH: Strong potential
- Demonstrable live or with a screenshot
- Counter-intuitive or surprising (triggers a reaction)
- Associated with verifiable numbers
- Concrete and actionable (explainable in 30 seconds)
- Differentiator vs other talks on the same topic
MEDIUM: Moderate potential
- Useful but expected (not surprising)
- Missing concrete proof or numbers
- Too specific to one particular context
- Needs too much explanation for a 30-min talk
LOW: Weak potential
- Too abstract or philosophical without concrete grounding
- Already heavily covered by other speakers
- Requires specific technical background
- Hard to illustrate in a slide
Scoring discipline: Max 30% HIGH. If everything is HIGH, nothing is.
Standard Categories
| Category |
Description |
| Architecture |
Technical decisions, stack, structural patterns |
| Tooling |
Tools, workflows, automations |
| Philosophy |
Principles, mindsets, approaches |
| Workflow |
Work processes, habits |
| Knowledge Transfer |
Onboarding, team, knowledge sharing |
| Problems |
Obstacles encountered, trade-offs |
| Open Source |
Contributions, sharing, community |
| AI Config |
AI configuration, profiles, knowledge feeding |
| AI Infrastructure |
Agents, skills, hooks, commands |
| AI Quality |
Review, tests, anti-patterns |
| AI Security |
Security hooks, guardrails |
| Optimization |
Performance, cost/token reduction |
Adapt or create categories if the talk has domain-specific areas.
Output Format
concepts.md
# Key Concepts: {provisional title}
**Date**: {date}
**Source**: {source path} x Summary x Timeline (if available)
---
## Concept table
| # | Concept | Category | Short description | Talk potential |
|---|---------|----------|------------------|----------------|
| 1 | **{Concept name}** | {Category} | {1-2 concrete sentences} | HIGH / MEDIUM / LOW |
...
---
## Category breakdown
| Category | Count | HIGH concepts | Examples |
|----------|-------|---------------|---------|
| {category} | {n} | {n} | {examples} |
...
| **TOTAL** | **{N}** | **{N HIGH}** | |
---
## Recommendations for positioning
{3-5 sentences on concept clusters that could form the talk's acts.
Which HIGH concepts reinforce each other? What narrative arc is emerging?}
concepts-enriched.md (if repo available)
Same structure but focused on what the repo analysis reveals:
- Specialized agents (count, size, roles)
- Invocable skills (catalogue, domains covered)
- System hooks (events, logic)
- Modular config (profiles, modules, pipeline)
- Project-specific code patterns
For each enriched concept, include:
- Exact source: file and approximate line
- Demo-able: yes/no (can it be shown in a slide or live?)
Anti-patterns
- Creating overly granular concepts (one feature = one concept max)
- Scoring HIGH by default (be selective)
- Omitting LOW concepts (they're useful in positioning as "angles to avoid")
- Duplicating very similar concepts (merge them instead)
- Analyzing repo code if the repo isn't accessible
Validation Checklist
Tips
- The concept catalogue is what Stage 4 (Position) draws from; the richer it is, the better the angle choices
- LOW concepts are valuable: they define the boundaries of what NOT to put in the talk
- If two concepts feel very similar, merge them (a smaller, sharper list beats a long diluted one)
Related
1---2name: talk-stage3-concepts3description: Builds a numbered, categorized concept catalogue from the talk summary and timeline, scoring each concept HIGH / MEDIUM / LOW for talk potential with optional repo enrichment. Use when you need a structured inventory of concepts before choosing a talk angle, or when assessing which ideas have the strongest presentation potential.4---5
6# Talk Stage 3: Concepts
7
8Builds an exhaustive catalogue of all identifiable concepts in the source material. Each concept is numbered, categorized, and scored for its talk potential.
9
10## When to Use This Skill
11
12- After Stage 1 (and Stage 2 if REX mode)
13- Before Stage 4 (Position needs the concept catalogue)
14- When you want a structured inventory of what's available before choosing an angle
15
16## What This Skill Does
17
181. **Reads the summary**: loads `{slug}-summary.md`
192. **Reads the timeline** (if available): enriches scoring with verified dates
203. **Extracts concepts**: full scan of the source material
214. **Categorizes**: assigns each concept to a domain category
225. **Scores**: HIGH / MEDIUM / LOW for talk potential
236. **Optional repo enrichment**: if repo_path is provided, analyzes AI config concepts
247. **Writes output files**
25
26## Input
27
28- `talks/{YYYY}-{slug}-summary.md` (required)
29- `talks/{YYYY}-{slug}-timeline.md` (optional, enriches REX concepts)
30- `repo_path` (optional, for config/infrastructure concept extraction)
31
32## Output
33
34- `talks/{YYYY}-{slug}-concepts.md` (main catalogue)
35- `talks/{YYYY}-{slug}-concepts-enriched.md` (if repo_path provided)
36
37## Scoring Criteria
38
39### HIGH: Strong potential
40- Demonstrable live or with a screenshot
41- Counter-intuitive or surprising (triggers a reaction)
42- Associated with verifiable numbers
43- Concrete and actionable (explainable in 30 seconds)
44- Differentiator vs other talks on the same topic
45
46### MEDIUM: Moderate potential
47- Useful but expected (not surprising)
48- Missing concrete proof or numbers
49- Too specific to one particular context
50- Needs too much explanation for a 30-min talk
51
52### LOW: Weak potential
53- Too abstract or philosophical without concrete grounding
54- Already heavily covered by other speakers
55- Requires specific technical background
56- Hard to illustrate in a slide
57
58**Scoring discipline**: Max 30% HIGH. If everything is HIGH, nothing is.
59
60## Standard Categories
61
62| Category | Description |
63|----------|-------------|
64| **Architecture** | Technical decisions, stack, structural patterns |
65| **Tooling** | Tools, workflows, automations |
66| **Philosophy** | Principles, mindsets, approaches |
67| **Workflow** | Work processes, habits |
68| **Knowledge Transfer** | Onboarding, team, knowledge sharing |
69| **Problems** | Obstacles encountered, trade-offs |
70| **Open Source** | Contributions, sharing, community |
71| **AI Config** | AI configuration, profiles, knowledge feeding |
72| **AI Infrastructure** | Agents, skills, hooks, commands |
73| **AI Quality** | Review, tests, anti-patterns |
74| **AI Security** | Security hooks, guardrails |
75| **Optimization** | Performance, cost/token reduction |
76
77Adapt or create categories if the talk has domain-specific areas.
78
79## Output Format
80
81### concepts.md
82
83```markdown
84# Key Concepts: {provisional title}
85
86**Date**: {date}
87**Source**: {source path} x Summary x Timeline (if available)
88
89---
90
91## Concept table
92
93| # | Concept | Category | Short description | Talk potential |
94|---|---------|----------|------------------|----------------|
95| 1 | **{Concept name}** | {Category} | {1-2 concrete sentences} | HIGH / MEDIUM / LOW |
96...
97
98---
99
100## Category breakdown
101
102| Category | Count | HIGH concepts | Examples |
103|----------|-------|---------------|---------|
104| {category} | {n} | {n} | {examples} |
105...
106| **TOTAL** | **{N}** | **{N HIGH}** | |
107
108---
109
110## Recommendations for positioning
111
112{3-5 sentences on concept clusters that could form the talk's acts.
113Which HIGH concepts reinforce each other? What narrative arc is emerging?}
114```
115
116### concepts-enriched.md (if repo available)
117
118Same structure but focused on what the repo analysis reveals:
119- Specialized agents (count, size, roles)
120- Invocable skills (catalogue, domains covered)
121- System hooks (events, logic)
122- Modular config (profiles, modules, pipeline)
123- Project-specific code patterns
124
125For each enriched concept, include:
126- **Exact source**: file and approximate line
127- **Demo-able**: yes/no (can it be shown in a slide or live?)
128
129## Anti-patterns
130
131- Creating overly granular concepts (one feature = one concept max)
132- Scoring HIGH by default (be selective)
133- Omitting LOW concepts (they're useful in positioning as "angles to avoid")
134- Duplicating very similar concepts (merge them instead)
135- Analyzing repo code if the repo isn't accessible
136
137## Validation Checklist
138
139- [ ] Minimum 15 concepts identified (20+ for REX with repo)
140- [ ] Each concept has a 1-2 sentence concrete description
141- [ ] Scores are calibrated (not all HIGH, not all LOW)
142- [ ] Categories cover the summary's themes
143- [ ] Positioning recommendations present
144- [ ] Files saved to correct paths
145
146## Tips
147
148- The concept catalogue is what Stage 4 (Position) draws from; the richer it is, the better the angle choices
149- LOW concepts are valuable: they define the boundaries of what NOT to put in the talk
150- If two concepts feel very similar, merge them (a smaller, sharper list beats a long diluted one)
151
152## Related
153
154- [Stage 1: Extract](../stage-1-extract/SKILL.md): prerequisite
155- [Stage 2: Research](../stage-2-research/SKILL.md): provides timeline (REX)
156- [Stage 4: Position](../stage-4-position/SKILL.md): reads this catalogue
157- [Orchestrator](../orchestrator/SKILL.md)