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.

Stars 3,172
Forks 439

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

  1. Reads the summary — loads {slug}-summary.md
  2. Reads the timeline (if available) — enriches scoring with verified dates
  3. Extracts concepts — full scan of the source material
  4. Categorizes — assigns each concept to a domain category
  5. Scores — HIGH / MEDIUM / LOW for talk potential
  6. Optional repo enrichment — if repo_path is provided, analyzes AI config concepts
  7. 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

markdown
# 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

Expand your agent's capabilities with these related and highly-rated skills.

FlorianBruniaux/claude-code-ultimate-guide

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.

3,172 439
Explore
FlorianBruniaux/claude-code-ultimate-guide

git-ai-archaeology

Analyze AI config evolution in a git repo — first commits per path, monthly distribution, major PRs, maturity phases

3,172 439
Explore
FlorianBruniaux/claude-code-ultimate-guide

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.

3,172 439
Explore
FlorianBruniaux/claude-code-ultimate-guide

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.

3,172 439
Explore
FlorianBruniaux/claude-code-ultimate-guide

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.

3,172 439
Explore
FlorianBruniaux/claude-code-ultimate-guide

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.

3,172 439
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results