tldr-overview
Get a token-efficient overview of any project using file tree, code structure, and call graph analysis.
- License 许可
- MIT
- 最近更新
- 2026-06-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- tldr-overview
- description
- Get a token-efficient overview of any project using file tree, code structure, and call graph analysis.
03 SKILL.md 正文
TLDR Project Overview
Get a token-efficient overview of any project using the TLDR stack.
Trigger
/overviewor/tldr-overview- "give me an overview of this project"
- "what's in this codebase"
- Starting work on an unfamiliar project
Execution
1. File Tree (Navigation Map)
tldr tree . --ext .py # or .ts, .go, .rs
2. Code Structure (What Exists)
tldr structure src/ --lang python --max 50
Returns: functions, classes, imports per file
3. Call Graph Entry Points (Architecture)
tldr calls src/
Returns: cross-file relationships, main entry points
4. Key Function Complexity (Hot Spots)
For each entry point found:
tldr cfg src/main.py main # Get complexity
Output Format
## Project Overview: {project_name}
### Structure
{tree output - files and directories}
### Key Components
{structure output - functions, classes per file}
### Architecture (Call Graph)
{calls output - how components connect}
### Complexity Hot Spots
{cfg output - functions with high cyclomatic complexity}
---
Token cost: ~{N} tokens (vs ~{M} raw = {savings}% savings)
When NOT to Use
- Already familiar with the project
- Working on a specific file (use targeted tldr commands instead)
- Test files (need full context)
Programmatic Usage
from tldr.api import get_file_tree, get_code_structure, build_project_call_graph
# 1. Tree
tree = get_file_tree("src/", extensions={".py"})
# 2. Structure
structure = get_code_structure("src/", language="python", max_results=50)
# 3. Call graph
calls = build_project_call_graph("src/", language="python")
# 4. Complexity for hot functions
for edge in calls.edges[:10]:
cfg = get_cfg_context("src/" + edge[0], edge[1])
04 同仓库更多 Skills
workflow-router
Goal-based workflow orchestration - routes tasks to specialist agents based on user goals
wiring
Wiring Verification
websocket-patterns
Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.
visual-verdict
Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS/REVISE/FAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.
verification-loop
Comprehensive verification system covering build, types, lint, tests, security, and diff review before a PR.
vector-db-patterns
Embedding strategies, ANN algorithms, hybrid search, RAG chunking strategies, and reranking for semantic search and retrieval.