skill-litho_skill

Overview

This skill is an AI-powered Rust documentation generation engine that turns codebases into clear, structured technical documentation and C4 architecture diagrams. It analyzes source code across languages, produces architecture models, and generates professional specs ready for teams and intelligent agents. Use it to automate documentation, reveal system structure, and create AI-ready context for downstream tools.

How this skill works

The engine scans the repository, extracts code structure, and builds multi-level C4 models (Context, Container, Component, Code). It uses configurable LLMs for research and natural-language drafting, and outputs a navigable documentation tree with diagrams and detailed topic deep-dives. Optional flags let you choose fast or powerful models, skip preprocessing, or integrate into CI pipelines.

When to use it

• You need a complete C4 architecture set (Context, Container, Component, Code).
• You want automated, repeatable documentation in CI/CD for evolving codebases.
• You must generate technical specifications and design decision records from source.
• You need quick codebase insights without a full documentation run.
• You want to create AI-ready context bundles for other agents or tools.

Best practices

• Start with a focused path using -p to limit scope for large repos and iterate.
• Use --model-efficient for preliminary scans and --model-powerful for final drafts to balance cost and quality.
• Batch large repositories and enable skipping phases (--skip-preprocessing) when memory is limited.
• Place generated docs under version control and include them in CI for continuous updates.
• Review generated architecture diagrams and add domain-specific corrections before publishing.

Example use cases

• Generate a full project-docs/ tree with architecture overview, workflow, and deep dives for onboarding new engineers.
• Run quick analysis on a pull request to summarize code changes and impacted components.
• Embed in CI to refresh documentation automatically when the main branch changes.
• Produce C4 diagrams for an executive architecture review or technical roadmap.
• Create AI-ready context artifacts for downstream agents to improve code search and automated code review.