skills.rest
tlehmantlehmanCommunity·1 Agent Skills Included

litprog-skill

Turn codebases into readable literate programs and PDFs

Transforms codebases into literate programs that weave prose, diagrams, and code into a single readable document. Extracts runnable source files from the document and syncs edits back automatically, eliminating stale documentation. Generates polished PDFs via Pandoc for onboarding, code reviews, and knowledge transfer.
241|15
↗
npx skills add tlehman/litprog-skill --all -g -y
Available:

Explains to the AI agent how the literate programming skill is structured, which tangle and weave commands to run, and how the reverse-sync hook keeps documents and source files consistent.

All Skills in This Repository (1)

Pure Emerald Level Indicators
📦 In Repo
tlehmantlehman

Literate Programming

Transform a codebase into a single .lit.md literate program document.

Community
Advanced

Frequently Asked Questions

FAQPage Schema
How to install litprog-skill?▼

Run `npx skills add tlehman/litprog-skill --all -g -y` in your terminal to install the skill globally.

What is literate programming?▼

It is an approach created by Donald Knuth where code is written as a narrative document for humans, which can also generate the runnable source files and a formatted PDF.

How do I create a literate program from my codebase?▼

Run the /literate-programming command in Claude Code and it will analyze your code, plan a narrative order, and produce a .lit.md file with prose, diagrams, and named code chunks.

What happens if I edit source files directly?▼

A PostToolUse hook detects the edit and automatically syncs the change back into the .lit.md file, keeping it as the single source of truth.

How do I generate a PDF from a literate program?▼

Run the weave command with Pandoc, xelatex, and mermaid-filter installed, or simply run /literate-programming again on an existing .lit.md file.

Related Repositories in Software Engineering

View All in Software Engineering→
openclawopenclaw
388.4k

openclaw

Run a personal AI assistant across your devices and chat apps

Official📦 120 Skills
obraobra
280.0k

superpowers

Gives coding agents a disciplined workflow from idea to merged code

Community📦 15 Skills
facebookfacebook
248.4k

react

AI agent skills for building, testing, and porting React core

Official📦 14 Skills