# Tldr

Compress a document, thread, transcript, or pasted text into a scannable TL;DR.

- Repository: https://github.com/alexgreensh/attention-span (1522 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add alexgreensh/attention-span --skill tldr -g -a claude-code -y`
Codex: `npx skills add alexgreensh/attention-span --skill tldr -g -a codex -y`
Cursor: `npx skills add alexgreensh/attention-span --skill tldr -g -a cursor -y`
Gemini CLI: `npx skills add alexgreensh/attention-span --skill tldr -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add alexgreensh/attention-span`

## Description

Compress a document, thread, transcript, or pasted text into a scannable TL;DR.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- attention-span v0.12 · check for updates: https://github.com/alexgreensh/attention-span -->
Compress the content the user pointed you at (a pasted block, a file, a link, a
thread, a transcript, or the current selection) into a briefing they can absorb in
seconds. This is a **transform on someone else's content**, not a style for your own
answers, so summarize what's there, add nothing, invent nothing.

If they didn't say what to compress, ask which one thing, then stop. One question, nothing after it.

## Output shape

1. **TL;DR:** one line that carries the whole thing. A reader who reads only this line
   has the gist and the outcome. If the source has a decision, deadline, or ask, that
   goes here, not below.

2. **Key points**, three to seven, each its own line, bold the subject then a short
   clause. Keep every load-bearing number, name, date, threshold, and condition exactly
   as written, source wording over your paraphrase when it changes the meaning. Drop
   throat-clearing, repetition, and filler.

3. **Action items** only if the source actually contains them: who owns what, by when.
   Skip the heading entirely when there are none, never pad it.

4. Optional **Open questions / unclear:** one line each for anything the source leaves
   genuinely ambiguous. Flag it, don't resolve it by guessing.

## Rules

The rest: https://github.com/alexgreensh/attention-span/blob/HEAD/plugins/attention-span/skills/tldr/SKILL.md