docs-from-code

​

Install

npx "@opendirectory.dev/skills" install docs-from-code --target claude

npx skills add Varnan-Tech/opendirectory --skill docs-from-code

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

​

What It Generates

​

Why graphify?

• 20 languages via tree-sitter AST: Python, TypeScript, Go, Rust, Java, and 15 more
• Architecture insight: god nodes and community clusters show what everything connects through
• 71.5x fewer tokens than reading raw files, efficient on large codebases
• SHA256 cache: re-runs only process changed files
• Honest tagging: EXTRACTED (found in source) vs INFERRED (reasonable inference with confidence score)
• Extracts rationale from # NOTE:, # WHY:, # HACK: comments and docstrings

​

Supported Languages (via graphify)

​

Requirements

• Python 3.10+ (for graphify)
• Node.js 18+ (for fallback TypeScript extractor)
• gh CLI (optional, for opening PRs automatically)
• GITHUB_TOKEN env var (optional, for PRs)

​

Setup

​

1. Set up graphify

pip install graphifyy

​

2. Configure (Optional)

cp .env.example .env
# Add GITHUB_TOKEN if you want auto-PR support

​

How to Use

"Generate a README for this project"
"My API docs are out of date, update them from the code"
"Create docs/API.md from my FastAPI routes"
"Add an architecture section to our README"
"Document this TypeScript library"

1. Run graphify . --no-viz to build a knowledge graph of your codebase
2. Read GRAPH_REPORT.md for god nodes, communities, and architecture insights
3. Query the graph for routes, types, and data models
4. Read existing docs to understand what needs updating
5. Generate accurate docs grounded in the graph
6. Write files and optionally open a GitHub PR

​

Project Structure

docs-from-code/
├── SKILL.md                         # Agent instructions
├── README.md                        # This file
├── .env.example                     # Environment variables template
├── scripts/
│   ├── package.json                 # Script dependencies (ts-morph)
│   ├── extract_ts.ts                # TypeScript/JS AST extractor
│   └── extract_py.py                # Python AST extractor
├── references/
│   ├── extraction-guide.md          # Per-framework extraction notes
│   └── output-template.md          # README and API.md templates
└── evals/
    └── evals.json                   # Test prompts

​

License