tldr

Create and update a rolling TLDR.md summary with session findings and decisions.

2|1|Updated Feb 8, 2021

Search Tags:#documentation #markdown #communication #session #summary #tldr

Ready to run

npx skills add https://github.com/jstoobz/dotfiles --skill tldr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tldr
Source: https://github.com/jstoobz/dotfiles/tree/main/claude/skills/session-kit/tldr
Command: npx skills add https://github.com/jstoobz/dotfiles --skill tldr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a concise TLDR.md summary for the current session, capturing key findings, decisions, and outcomes.

Core Features & Use Cases

Roll-forward summaries: Read existing TLDR.md and prepend new content with a timestamp, preserving previous notes to create a rolling history.
Structured content: Collect what was investigated, notable findings, decisions, actions taken, and open items into a shareable format.
Use Case: After a design review or debugging session, generate a clean TLDR.md to quickly brief teammates before diving into full analysis.

Quick Start

Run the TLDR command in the active session to generate or update TLDR.md with the latest highlights.

Frequently Asked Questions about tldr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate a markdown summary of my debugging session for teammates?▼

To generate a markdown summary of your debugging session, this skill creates a concise TLDR.md file capturing key findings, decisions, and actions taken. It formats the output specifically for engineer-friendly sharing.

What is the best way to maintain a rolling history of session summaries in markdown?▼

Maintaining a rolling history of session summaries is done by prepending new content with a timestamp while preserving previous notes. The skill updates TLDR.md in your working directory to create a chronological log of investigations.

How do I document design review outcomes and open items for quick briefings?▼

Documenting design review outcomes is achieved by structuring investigated topics, notable findings, decisions, and open items into a shareable format. The skill outputs a clean TLDR.md file to quickly brief teammates before full analysis.

Does the TLDR markdown generator require any external dependencies?▼

The TLDR markdown generator requires no external dependencies to function. It operates entirely within the active session to read or create the TLDR.md file in your working directory.

Can I automate session documentation across ongoing conversations?▼

Automating session documentation across ongoing conversations is fully supported. The skill operates across active sessions, maintaining a rolling history by reading existing TLDR.md files and prepending the latest highlights.