Litho Document Skill

What it does

When your agent uses it

• Asks to generate project documentation
• Analyze codebase architecture
• Create C4 architecture diagrams
• Document a repository

Example prompts

• “generate project documentation”
• “analyze codebase architecture”
• “create C4 architecture diagrams”
• “/litho-document-skill”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1每个章节开头必须有叙述性 summary：用 2-4 句话先解释"这个章节在说什么、为什么重要"，不要直接甩出表格或列表
2. 2表格和列表前后必须有解读段落：不要只给结构化数据，要解释"这意味着什么、为什么这样设计"
3. 3设计决策必须讲"为什么"：不只说"选了什么"，还要说"放弃了什么、为什么这样选"
4. 4用类比和比喻建立理解桥梁：比如把 Memory 比作"快递站"、把 Agent 比作"工人"、把 Pipeline 比作"生产线"
5. 5避免冷冰冰的标题堆叠：章节标题应该自然引出叙述，而不是 ### 2.1 核心目标 → 直接跳到列表

What it can do on your machine

Read from SKILL.md and the folder at commit 0746b38. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Litho Document Skill loads about 1.4k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 191 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~191

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~16k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sopaco/terrain at commit 0746b38, republished under its MIT licence (© sopaco). 306 words, ~1,357 tokens.

name

litho-document-skill

description

This skill should be used when the user asks to "generate project documentation", "analyze codebase architecture", "create C4 architecture diagrams", "document a repository", "generate technical docs", "使用 Litho 生成文档", "分析代码库架构", "生成架构文档", "为项目生成技术文档", "生成 C4 模型文档", "为这个项目写文档", "自动生成文档", "帮我分析这个代码库", or any request involving automated documentation generation for a software project. This skill enables the AI agent to autonomously analyze any codebase and produce high-quality C4 architecture documentation (Overview, Architecture, Workflow, Deep-Exploration modules, Boundary Interfaces, Database Overview) — equivalent to what deepwiki-rs produces — purely through agent reasoning and tool usage, without depending on any external binary.

version

3.0.0

预处理 → 研究 → 编排 → 输出
 ↓        ↓       ↓       ↓
结构洞察   C1-C4   Markdown   文件持久化

{TERRAIN_LITHO_WORKSPACE}/   # 或 .terrain/.litho-agent/
├── preprocessing.md        ← 预处理报告（阶段一产出）
├── c1-system-context.md    ← 系统上下文报告
├── c2-domain-modules.md    ← 领域模块报告
├── architecture.md         ← 架构研究报告
├── workflow.md             ← 工作流研究报告
├── boundary.md             ← 边界接口报告
├── database.md             ← 数据库报告（条件）
└── modules/                ← 各模块深度报告
    ├── llm.md
    ├── cache.md
    └── ...

{TERRAIN_HUMAN_OUTPUT_DIR}/
├── 1.概述.md
├── 2.架构.md
├── 3.工作流.md
├── 4.Deep-Exploration/{module}.md
├── 5.边界接口.md
└── 6.数据库概览.md

© sopaco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in preset_skills/litho-documents-skill of sopaco/terrain.

• SKILL.md
• _meta.json
• references/doc-templates.md
• references/phase1-preprocessing.md
• references/phase2-research.md
• references/phase3-composition.md
• references/phase4-output.md
• skill-card.md

Open the folder on GitHubat commit 0746b38