AI SummaryCodeFlow (braedonsaunders, MIT) turns any GitHub repository, local folder, PR, or markdown/Obsidian vault into an interactive architecture map — entirely in the browser. It is a single
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to install the "codeflow" skill in my project. Please run this command in my terminal: # Install skill into your project (5 files) mkdir -p .claude/skills/codeflow && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/codeflow/SKILL.md "https://raw.githubusercontent.com/akillness/jeo-skills/main/.agent-skills/codeflow/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/codeflow/SKILL.toon "https://raw.githubusercontent.com/akillness/jeo-skills/main/.agent-skills/codeflow/SKILL.toon" && mkdir -p .claude/skills/codeflow/evals && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/codeflow/evals/evals.json "https://raw.githubusercontent.com/akillness/jeo-skills/main/.agent-skills/codeflow/evals/evals.json" && mkdir -p .claude/skills/codeflow/references && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/codeflow/references/features.md "https://raw.githubusercontent.com/akillness/jeo-skills/main/.agent-skills/codeflow/references/features.md" && mkdir -p .claude/skills/codeflow/scripts && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/codeflow/scripts/install.sh "https://raw.githubusercontent.com/akillness/jeo-skills/main/.agent-skills/codeflow/scripts/install.sh" Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.
Description
Turn any GitHub repo, local folder, PR, or markdown/Obsidian vault into an interactive architecture map with CodeFlow — a zero-build single index.html browser app (React 18 + D3.js from pinned CDNs) that runs 100% client-side with no backend and no data collection. Pick an input (public repo, private repo with a local token, local files, PR URL, markdown vault), choose a visualization mode (folder/layer/churn/blast), and read the analysis — dependency graph, blast radius, code ownership, heuristic security scanner, pattern/anti-pattern detection, A–F health score, activity heatmap, PR impact — then export JSON/Markdown/text/SVG/PDF or wire the self-updating CodeFlow Card SVG onto a README.
Prerequisites
| Requirement | Notes | |-------------|-------| | A modern browser | The whole app runs client-side; nothing is installed | | git (optional) | Only to self-host: git clone the one-file repo | | A GitHub token (optional) | For private repos and higher rate limits — kept in browser memory only, never stored | | Node.js (optional) | Only the npx skills installer or the parser unit tests (node --test tests/) need it |
codeflow — Visualize Codebase Architecture in Seconds
CodeFlow (braedonsaunders, MIT) turns any GitHub repository, local folder, PR, or markdown/Obsidian vault into an interactive architecture map — entirely in the browser. It is a single index.html app that loads pinned React 18 + D3.js 7 + Babel from CDNs: no build process, no npm install, no backend, and no data collection — your code is fetched directly from GitHub to your browser (or read from local files) and never leaves your machine. This skill is the routing-first wrapper: pick an input, choose a visualization mode, read the analysis, and export the result (or wire the self-updating CodeFlow Card onto a README).
When to use this skill
• The user opened an unfamiliar codebase and wants a fast architecture overview — an interactive dependency graph they can drag, zoom, and explore • The user asks "if I change this file, what breaks?" → blast-radius analysis over the dependency graph • The user wants code ownership (top contributors per file from git history) for a review or "who do I ask?" decision • The user wants an A–F codebase health score (dead code, circular dependencies, coupling, security issues) or an activity heatmap • The user wants a heuristic security / pattern scan — hardcoded secrets, SQL injection, eval(), debug statements; singleton/factory/observer/React hooks, and anti-patterns (God Objects, high coupling) • The user wants PR impact analysis — paste a PR URL to see affected files and the change's blast radius • The user wants to visualize an Obsidian vault / markdown directory as a note graph ([wiki-links]] and [text become edges) • The user wants to export the analysis (JSON / Markdown / text / SVG / PDF) or drop a self-updating CodeFlow Card SVG on a README
When not to use this skill
• The user wants editable, hand-authored diagrams (architecture, ERD, UML, sequence, flowchart) → use drawio or mermaid • The user wants token-efficient code search for an agent over a repo (find a symbol, semantic find-related) → use semble • The user wants a routing-first repo-navigation packet for definitions/references/impact before refactoring → use codebase-search • The user wants a durable, regenerable knowledge graph committed to the repo (.graphify/) rather than a throwaway browser view → use graphify • The user wants a deep, language-accurate static-analysis / call graph — CodeFlow's dependency analysis is heuristic (name-matched functions, scoped by file + explicit imports) and may miss dynamic imports or renamed runtime references; it is a quick overview, not 100% accuracy
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster