TL;DR Expert
Overview
The TL;DR Expert skill produces clear, concise summaries of technical content. It applies structured patterns to distill complex information into actionable briefs at the right level of detail for the audience.
When to use: Writing PR descriptions, summarizing code changes for reviewers, creating executive briefs for stakeholders, distilling long discussions into decisions and action items, or generating release notes.
When NOT to use: Writing full documentation (use the docs skill), producing marketing copy, creating detailed tutorials, or writing specifications that require exhaustive coverage.
Quick Reference
| Pattern |
Format |
Key Points |
| Executive summary |
Conclusion first, then evidence, then details |
Lead with the recommendation; inverted pyramid |
| PR description |
What changed, why, how to test |
Reviewers read the title and first paragraph |
| Code change |
Files changed, key decisions, impact areas |
Focus on intent, not line-by-line diff |
| Meeting notes |
Decisions, action items, open questions |
Skip discussion; capture outcomes |
| Release notes |
User-facing changes, breaking changes, migration |
Write for users, not developers |
| Technical brief |
Problem, solution, alternatives, recommendation |
One page max; link to details |
Common Mistakes
| Mistake |
Correct Pattern |
| Too verbose; includes every detail |
Cut to 20% of original length while keeping 80% of value |
| Missing context; assumes reader knows |
Include one sentence of background before the summary |
| Burying the lead in the third paragraph |
First sentence states the conclusion or key change |
| No actionable items in meeting notes |
Every meeting summary ends with owners and deadlines |
| Summarizing HOW instead of WHY |
Lead with intent and impact, not implementation details |
| No audience awareness |
Adjust depth: exec = 3 bullets, dev = 1 paragraph |
| Release notes written for developers |
Focus on what users can do differently, not code changes |
| PR description says "various fixes" |
List each change with a reason; vague helps no one |
| Missing breaking changes in release notes |
Breaking changes get their own section with migration steps |
| Using jargon for non-technical audience |
Match vocabulary to the reader's expertise level |
Delegation
- Content discovery: Use
Explore agent to gather source material
- Detailed review: Use
Task agent for thorough analysis before summarizing
- Code review: Delegate to
code-reviewer agent for change impact assessment
If the docs skill is available, delegate full documentation tasks to it.
References
- Summarization patterns, templates, and progressive disclosure
1---
2name: tldr-expert
3description: |
4 Concise summarization and information distillation. Covers executive summaries, code change summaries, PR descriptions, meeting notes, technical briefs, and progressive disclosure patterns.
5
6 Use when writing PR descriptions, summarizing code changes, creating executive briefs, distilling long discussions, or generating release notes.
7license: MIT
8metadata:
9 author: oakoss
10 version: '1.0'
11---
12
13# TL;DR Expert
14
15## Overview
16
17The TL;DR Expert skill produces clear, concise summaries of technical content. It applies structured patterns to distill complex information into actionable briefs at the right level of detail for the audience.
18
19**When to use:** Writing PR descriptions, summarizing code changes for reviewers, creating executive briefs for stakeholders, distilling long discussions into decisions and action items, or generating release notes.
20
21**When NOT to use:** Writing full documentation (use the `docs` skill), producing marketing copy, creating detailed tutorials, or writing specifications that require exhaustive coverage.
22
23## Quick Reference
24
25| Pattern | Format | Key Points |
26| ----------------- | ------------------------------------------------ | ---------------------------------------------- |
27| Executive summary | Conclusion first, then evidence, then details | Lead with the recommendation; inverted pyramid |
28| PR description | What changed, why, how to test | Reviewers read the title and first paragraph |
29| Code change | Files changed, key decisions, impact areas | Focus on intent, not line-by-line diff |
30| Meeting notes | Decisions, action items, open questions | Skip discussion; capture outcomes |
31| Release notes | User-facing changes, breaking changes, migration | Write for users, not developers |
32| Technical brief | Problem, solution, alternatives, recommendation | One page max; link to details |
33
34## Common Mistakes
35
36| Mistake | Correct Pattern |
37| ----------------------------------------- | ----------------------------------------------------------- |
38| Too verbose; includes every detail | Cut to 20% of original length while keeping 80% of value |
39| Missing context; assumes reader knows | Include one sentence of background before the summary |
40| Burying the lead in the third paragraph | First sentence states the conclusion or key change |
41| No actionable items in meeting notes | Every meeting summary ends with owners and deadlines |
42| Summarizing HOW instead of WHY | Lead with intent and impact, not implementation details |
43| No audience awareness | Adjust depth: exec = 3 bullets, dev = 1 paragraph |
44| Release notes written for developers | Focus on what users can do differently, not code changes |
45| PR description says "various fixes" | List each change with a reason; vague helps no one |
46| Missing breaking changes in release notes | Breaking changes get their own section with migration steps |
47| Using jargon for non-technical audience | Match vocabulary to the reader's expertise level |
48
49## Delegation
50
51- **Content discovery**: Use `Explore` agent to gather source material
52- **Detailed review**: Use `Task` agent for thorough analysis before summarizing
53- **Code review**: Delegate to `code-reviewer` agent for change impact assessment
54
55> If the `docs` skill is available, delegate full documentation tasks to it.
56
57## References
58
59- [Summarization patterns, templates, and progressive disclosure](references/summarization-patterns.md)
oakoss