# tldr-overview

Скилл собирает карту незнакомого проекта через стек TLDR: дерево файлов, структуру кода, граф вызовов и сложные функции.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 485 установок · ★ 3946
- Автор: parcadei
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/skills/tldr-overview/SKILL.md
- Обновлён: 2026-01-26
- HTML: https://affpapa.org/nevibecode/skills/tldr-overview

## Что делает

Скилл запускается на `/overview` или `/tldr-overview`, а ещё на фразы вроде «дай обзор проекта» или «что тут вообще в кодовой базе». Дальше он проходит четыре шага: строит дерево файлов, вытаскивает функции, классы и импорты по каждому файлу, собирает граф вызовов между файлами и считает цикломатическую сложность у точек входа. На выходе — блок с разделами «Structure», «Key Components», «Architecture» и «Complexity Hot Spots» плюс строка про потраченные токены и экономию против чтения сырых файлов.

Внутри скилл опирается на команды `tldr tree`, `tldr structure`, `tldr calls` и `tldr cfg`. Язык задаётся флагом: `--lang python`, `--ext .py` и подобные. Есть и программный путь через Python-API: `get_file_tree`, `get_code_structure`, `build_project_call_graph`, `get_cfg_context` из `tldr.api`. Значит, для работы нужен установленный TLDR — без него шаги просто не выполнятся.

Автор сам перечисляет случаи, когда скилл не нужен: проект уже знаком, работа идёт по одному конкретному файлу или это тесты, где нужен полный контекст. Это честное ограничение, и его стоит держать в голове — на тестах обзор по структуре даст неполную картину.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-overview -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/tldr-overview/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/tldr-overview/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-overview -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/tldr-overview/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-overview -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/tldr-overview/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install parcadei/Continuous-Claude-v3 tldr-overview
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/tldr-overview/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-overview -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/parcadei/Continuous-Claude-v3 --path .claude/skills/tldr-overview
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/tldr-overview/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-overview -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/skills/tldr-overview/SKILL.md

## Когда брать
- получить карту незнакомого репозитория до первой правки
- найти точки входа и связи между файлами
- вычислить функции с высокой цикломатической сложностью
- срезать расход токенов на чтение сырых исходников
- понять структуру проекта перед рефакторингом

## Примеры запросов агенту
- /tldr-overview
- дай обзор этого проекта
- что вообще в этой кодовой базе

## Похожие
- [create-tldr-page](https://affpapa.org/nevibecode/skills/create-tldr-page.md) — скилл · 8800 установок
- [grepai-trace-graph](https://affpapa.org/nevibecode/skills/grepai-trace-graph.md) — скилл · 802 установки
- [diagramming-code](https://affpapa.org/nevibecode/skills/diagramming-code.md) — скилл · 4200 установок
- [rust-call-graph](https://affpapa.org/nevibecode/skills/rust-call-graph.md) — скилл · 3200 установок
- [analyze-project](https://affpapa.org/nevibecode/skills/analyze-project.md) — скилл · 337200 установок
- [caveman](https://affpapa.org/nevibecode/skills/caveman-2.md) — скилл · 3700 установок

Из того же набора: [parcadei/continuous-claude-v3](https://affpapa.org/nevibecode/by/parcadei/continuous-claude-v3.md) — 69 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md