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