Speckit TLDR
qurore/speckit-tldr
TLDR orientada a revisão para specs e plans do Spec Kit
Ver no GitHubPlugin Claude Code que transforma arquivos spec.md e plan.md do GitHub Spec Kit em TLDRs orientadas para revisão — um dashboard HTML + versão Markdown native para PR. Permite que revisores identifiquem riscos e ambiguidades antes de ler o documento completo, com rastreamento de mudanças no PR.
Instalação
npx convez-ai qurore/speckit-tldr1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Resumir especificações técnicas para revisão de PR
- Identificar riscos e ambiguidades em documentos de design
- Comparar mudanças entre spec e plan em um único painel
Veredito

Ferramenta prática e bem pensada para times que usam GitHub Spec Kit. Resolve um problema real de fricção em code review ao surfaçar intent, riscos e deltas automaticamente — com a honestidade de deixar claro que é entry point, não substituto da leitura completa.
README
A tradução para o português deste README ainda está na fila.
speckit-tldr
A Claude Code plugin that turns
GitHub Spec Kit spec.md and plan.md
files into review-oriented TLDRs — a self-contained HTML dashboard plus a
PR-native Markdown version — so a reviewer can get oriented and spot the risky
parts before reading the full document.
It is built for the PR reviewer: it regenerates from the canonical files, surfaces ambiguities / open questions / spec↔plan mismatches at the top, and marks what changed in the PR. The TLDR is an entry point into the document, not a replacement for reading it — every item links back to its source location.
What it does
spec.md→ intent, requirements (with acceptance criteria), decisions, and open questions, flagged for ambiguity / untestability / missing criteria.plan.md→ stack, design decisions paired with rationale, Constitution Check results, structure, and risks, flagged for mismatch / constitution violations / unexplained decisions.- Diff-aware: items touched by the current PR are marked, with a "show only changed" filter in the HTML.
- Cleanup: a companion
tldr-deleteskill removes the generated TLDRs again so these local review artifacts never get committed into the PR.
Install
Run these in Claude Code.
From the Claude community marketplace
/plugin marketplace add anthropics/claude-plugins-community
/plugin install speckit-tldr@claude-community
The community-marketplace entry becomes installable once the submission is approved and synced; until then, use the direct method below.
Directly from this repo
/plugin marketplace add qurore/speckit-tldr
/plugin install speckit-tldr@speckit-tldr
Use
/speckit-tldr:tldr # both spec.md and plan.md for the current feature
/speckit-tldr:tldr plan # plan only
/speckit-tldr:tldr spec # spec only
/speckit-tldr:tldr specs/042-export/plan.md # a specific file
It also triggers from natural language ("tldr the auth feature spec",
"summarize this plan.md for review"). Output is written to
specs/<feature>/tldr/ as *.tldr.html and *.tldr.md.
Clean up before a PR
The TLDRs are a local reviewing aid, not something the PR should carry. Remove them again with:
/speckit-tldr:tldr-delete # remove the current feature's TLDRs
/speckit-tldr:tldr-delete plan # only the plan TLDR
/speckit-tldr:tldr-delete all # every *.tldr.* under specs/ in the repo
It lists exactly what it will remove and asks before deleting, removes already
committed files with git rm (so the deletion lands in the PR), can offer to add
the patterns to .gitignore, and only ever touches *.tldr.html / *.tldr.md —
never spec.md / plan.md.
Repo layout
speckit-tldr/
├── .claude-plugin/marketplace.json # marketplace catalog
├── plugins/speckit-tldr/
│ ├── .claude-plugin/plugin.json # plugin manifest
│ └── skills/
│ ├── tldr/ # generate the TLDR
│ │ ├── SKILL.md
│ │ ├── references/ # spec/plan extraction profiles + flag taxonomy
│ │ │ ├── extraction-spec.md
│ │ │ └── extraction-plan.md
│ │ └── assets/ # output templates
│ │ ├── tldr.template.html
│ │ └── tldr.template.md
│ └── tldr-delete/ # remove generated TLDRs before a PR
│ └── SKILL.md
├── LICENSE
└── README.md
Development
Test against a local clone before publishing changes:
claude plugin validate . # validate marketplace.json
claude plugin validate ./plugins/speckit-tldr # validate plugin.json + skill frontmatter
# In Claude Code, from the repo root:
/plugin marketplace add .
/plugin install speckit-tldr@speckit-tldr
/speckit-tldr:tldr # run against a real specs/<feature>/ in some repo
Plugin versions:
plugin.jsonpinsversion(0.2.0). Bump it on each release, or remove it to let every commit count as a new version.
License
MIT — see LICENSE.