Agent skill
talk-stage3-concepts
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.
Install this agent skill to your Project
npx add-skill https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/main/examples/skills/talk-pipeline/stage-3-concepts
SKILL.md
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} × Summary × 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
- Minimum 15 concepts identified (20+ for REX with repo)
- Each concept has a 1-2 sentence concrete description
- Scores are calibrated (not all HIGH, not all LOW)
- Categories cover the summary's themes
- Positioning recommendations present
- Files saved to correct paths
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
- Stage 1: Extract — prerequisite
- Stage 2: Research — provides timeline (REX)
- Stage 4: Position — reads this catalogue
- Orchestrator
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
eval-skills
Audit all skills in the current project for frontmatter completeness, effort level appropriateness, allowed-tools scoping, and content quality. Produces a scored report with effort-level recommendations for each skill. Use when onboarding to a new project, reviewing skill quality before shipping, or adding effort fields to an existing skill library.
git-ai-archaeology
Analyze AI config evolution in a git repo — first commits per path, monthly distribution, major PRs, maturity phases
design-patterns
Detect, suggest, and evaluate GoF design patterns in TypeScript/JavaScript codebases. Use when refactoring code, applying singleton/factory/observer/strategy patterns, reviewing pattern quality, or finding stack-native alternatives for React, Angular, NestJS, and Vue.
rtk-optimizer
Wrap high-verbosity shell commands with RTK to reduce token consumption. Use when running git log, git diff, cargo test, pytest, or other verbose CLI output that wastes context window tokens.
pr-triage
4-phase PR backlog management with audit, deep code review, validated comments, and optional worktree setup. Use when triaging pull requests, catching up on pending code reviews, or managing a backlog of open PRs. Args: 'all' to review all, PR numbers to focus (e.g. '42 57'), 'en'/'fr' for language, no arg = audit only.
guide-recap
Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Newsletter, Slack) in FR + EN. Use after releases or weekly to generate release notes, announcements, social media posts, or recap summaries from guide updates.
Didn't find tool you were looking for?