Agent skill

Code Flow Visualizer

by wentorai in wentorai/research-plugins

Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts

MITAuto-check passedDevelopment

Install Code Flow Visualizer

skills CLI
$ npx skills add wentorai/research-plugins --skill code-flow-visualizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins code-flow-visualizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tools/diagram/code-flow-visualizer .claude/skills/code-flow-visualizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-flow-visualizer
GitHub stars
298
Used in
1 other repo
Token cost
~1.9k tokens
SKILL.md length
470 words
Files
1
Skills in repo
428
Repo updated
First seen
Licence
MIT

At a glance

Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts

  • Works in 4 steps: Scope: Works best for functions under… → Dynamic dispatch: Cannot trace through… → Concurrency: Async/await is shown… → …
  • Tasks that involve Diagrams
  • SKILL.md covers Overview, Conversion Rules, Handling Complex Patterns and Styling for Documentation, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Code Flow Visualizer is an agent skill from wentorai/research-plugins. Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Diagrams. It works with JavaScript, Python, TypeScript and Mermaid. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Diagrams

Example prompts

  • “/code-flow-visualizer”

Requirements

  • Python 3

Workflow steps

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

  1. Scope: Works best for functions under 100 lines. For larger codebases, visualize individual functions or extract key subroutines.
  2. Dynamic dispatch: Cannot trace through dynamic method resolution or callback chains. Show these as labeled subroutine nodes.
  3. Concurrency: Async/await is shown sequentially. Concurrent branches (e.g., Promise.all) are noted but not fully modeled.
  4. Simplification: Omit trivial assignments and logging statements to keep diagrams focused on control flow.

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. 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 (its code samples are mermaid, python, typescript, bash and latex).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • mermaid.js.org
    • docs.python.org

    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

Code Flow Visualizer loads about 1.9k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 470 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 470 words, ~1,899 tokens.

Download SKILL.mdSave it as .claude/skills/code-flow-visualizer/SKILL.md (or your agent's skills folder).
name
code-flow-visualizer
description
Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts

Code Flow Visualizer

Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts by analyzing control flow structures. This skill helps researchers document and understand complex algorithmic logic, data processing pipelines, and experimental workflows embedded in code.

Overview

Research code often contains intricate control flow: nested conditionals for data filtering, loops over experimental conditions, error handling for API calls, and branching logic for different analysis paths. Understanding this flow is critical for reproducibility, code review, and documentation, yet reading nested code can be cognitively demanding.

This skill translates source code into visual Mermaid flowcharts by parsing control flow structures (if/else, for/while loops, try/catch, match/switch, return statements) and mapping them to flowchart nodes and edges. The resulting diagrams serve as documentation supplements in README files, lab notebooks, and paper appendices.

The approach works by performing a lightweight static analysis of the code's abstract syntax tree (AST). Each control structure maps to a specific flowchart pattern: conditionals become diamond decision nodes, loops become cycles with back-edges, function calls become subroutine nodes, and return statements become terminal nodes.

Conversion Rules

Control Flow Mapping
Code StructureFlowchart ElementMermaid Shape
Function entryStart node([Function Name])
Assignment / expressionProcess node[statement]
if / else ifDecision diamond{condition?}
for / while loopDecision + back-edge{loop condition?} with cycle
try / catchProcess + error path[try block] with dashed error edge
return / yieldTerminal / output node([return value])
Function callSubroutine node[[function_name()]]
match / switchMulti-branch decision{value?} with labeled edges
Python Example

Input code:

python
def process_papers(papers, min_citations=10):
    results = []
    for paper in papers:
        if paper.year < 2015:
            continue
        if paper.citation_count < min_citations:
            continue
        try:
            abstract = fetch_abstract(paper.doi)
            embeddings = compute_embeddings(abstract)
            results.append({"paper": paper, "embedding": embeddings})
        except APIError:
            log_error(paper.doi)
    return results

Output flowchart:

mermaid
flowchart TD
    Start(["process_papers(papers, min_citations=10)"]) --> Init["results = [ ]"]
    Init --> Loop{"For each paper in papers?"}
    Loop -->|Done| Return(["Return results"])
    Loop -->|Next paper| YearCheck{"paper.year < 2015?"}
    YearCheck -->|Yes| Loop
    YearCheck -->|No| CitCheck{"citation_count < min_citations?"}
    CitCheck -->|Yes| Loop
    CitCheck -->|No| TryBlock["abstract = fetch_abstract(paper.doi)"]
    TryBlock --> Embed["embeddings = compute_embeddings(abstract)"]
    Embed --> Append["results.append(...)"]
    Append --> Loop
    TryBlock -.->|APIError| LogErr["log_error(paper.doi)"]
    LogErr --> Loop
JavaScript / TypeScript Example

Input code:

typescript
async function searchPapers(query: string, maxResults: number = 50): Promise<Paper[]> {
    const cached = await cache.get(query);
    if (cached) return cached;

    const results: Paper[] = [];
    let offset = 0;

    while (results.length < maxResults) {
        const batch = await api.search(query, offset, 10);
        if (batch.length === 0) break;

        for (const paper of batch) {
            if (paper.isRetracted) continue;
            results.push(paper);
        }
        offset += 10;
    }

    await cache.set(query, results);
    return results;
}

Output flowchart:

mermaid
flowchart TD
    Start(["searchPapers(query, maxResults=50)"]) --> Cache["cached = await cache.get(query)"]
    Cache --> CacheHit{"cached exists?"}
    CacheHit -->|Yes| ReturnCached(["Return cached"])
    CacheHit -->|No| InitResults["results = [ ], offset = 0"]
    InitResults --> WhileLoop{"results.length < maxResults?"}
    WhileLoop -->|No| SaveCache["await cache.set(query, results)"]
    WhileLoop -->|Yes| Fetch["batch = await api.search(query, offset, 10)"]
    Fetch --> EmptyCheck{"batch.length === 0?"}
    EmptyCheck -->|Yes| SaveCache
    EmptyCheck -->|No| ForLoop{"For each paper in batch?"}
    ForLoop -->|Done| IncOffset["offset += 10"]
    IncOffset --> WhileLoop
    ForLoop -->|Next| Retracted{"paper.isRetracted?"}
    Retracted -->|Yes| ForLoop
    Retracted -->|No| Push["results.push(paper)"]
    Push --> ForLoop
    SaveCache --> Return(["Return results"])

Handling Complex Patterns

Nested Conditionals

Deeply nested if/else chains are flattened into a decision tree. Each branch is labeled with its condition, and nodes at the same depth are arranged vertically for readability.

Show full SKILL.md (182 more words)Show less
Recursive Functions

Recursive calls are shown as subroutine nodes with a self-referencing edge back to the function start node. A note annotation indicates the recursion base case.

Generator Functions (yield)

Python generators use yield as intermediate output nodes (shown as parallelogram shapes). The flowchart shows the suspension point and resumption path.

Error Handling Chains

Multiple except clauses create parallel error paths from the try block, each labeled with the exception type. finally blocks are shown as a converging node that all paths pass through.

Styling for Documentation

Academic Paper Style
mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#f8f9fa',
    'primaryBorderColor': '#212529',
    'primaryTextColor': '#212529',
    'lineColor': '#495057',
    'fontFamily': 'Times New Roman, serif',
    'fontSize': '14px'
  }
}}%%
flowchart TD
    A["Step 1"] --> B{"Decision"} --> C["Step 2"]
Export for LaTeX
bash
# Render Mermaid to PDF for LaTeX inclusion
mmdc -i flowchart.mmd -o flowchart.pdf -t neutral -b transparent
latex
\begin{figure}[h]
    \centering
    \includegraphics[width=0.8\textwidth]{flowchart.pdf}
    \caption{Control flow of the data processing pipeline.}
    \label{fig:flowchart}
\end{figure}

Limitations and Best Practices

  1. Scope: Works best for functions under 100 lines. For larger codebases, visualize individual functions or extract key subroutines.
  2. Dynamic dispatch: Cannot trace through dynamic method resolution or callback chains. Show these as labeled subroutine nodes.
  3. Concurrency: Async/await is shown sequentially. Concurrent branches (e.g., Promise.all) are noted but not fully modeled.
  4. Simplification: Omit trivial assignments and logging statements to keep diagrams focused on control flow.

References

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

Files

Just SKILL.md in skills/tools/diagram/code-flow-visualizer of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Code Flow Visualizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Flow Visualizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Flow Visualizer this skillwentorai/research-plugins2981 repos~1.9kAutomated safety check: PassMIT
Code To Chartrongxinzy/RongxinAI154—~596Automated safety check: PassMIT
CodeScope Codebase Graph AnalysisQwenLM/qwen-code28k1 repos~9.3kAutomated safety check: PassApache-2.0
Generating Documentationancoleman/ai-design-components526—~3kAutomated safety check: PassMIT
Microsim Generatordmccreary/ibook-skills105—~11kAutomated safety check: PassNone
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Code To Chart

    rongxinzy/RongxinAI

    解析代码仓库的 import/依赖关系,自动生成架构图、流程图和组织架构图,输出 Mermaid 文本或 SVG 图片。支持 Python、JavaScript、TypeScript、Go 和 Java 项目。当用户需要可视化代码结构、分析模块依赖、生成架构文档,或提及“代码架构图”、“依赖关系图”、“流程图”、“组织架构图”、“Mermaid 图”等关键词时触发。

    154 GitHub stars~596 tokensUpdated today
    DevelopmentAuto-check passed
  • Answers questions about code structure, history, bugs and PR risk using a CodeScope knowledge graph and semantic index built from the repository.

    28k GitHub starsUsed in 1 repo~9.3k tokens
    DevelopmentAuto-check passed
  • Generating Documentation

    ancoleman/ai-design-components

    Generate comprehensive technical documentation including API docs (OpenAPI/Swagger), code documentation (TypeDoc/Sphinx), documentation sites (Docusaurus/MkDocs), Architecture Decision Records…

    526 GitHub stars~3k tokensUpdated 10 mo ago
    DevelopmentAuto-check passed
  • Microsim Generator

    dmccreary/ibook-skills

    Creates interactive educational MicroSims, routing to the best-matched generator - p5.js, Chart.js, Plotly, Mermaid, vis-network, timelines, maps, Venn, causal-loop/feedback-loop diagrams (CLD)…

    105 GitHub stars~11k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Measures a code port between languages or frameworks with jscpd's function-level comparison, porting tests before code and tracking what is left unmatched.

    6.3k GitHub stars~5k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from wentorai/research-plugins

All 428 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Categories

Questions about Code Flow Visualizer

What does Code Flow Visualizer do?

Convert Python, JavaScript, and TypeScript functions into Mermaid flowcharts. Code Flow Visualizer is an agent skill from wentorai/research-plugins.

When should I use Code Flow Visualizer?

Code Flow Visualizer fits situations like: tasks that involve Diagrams.

How do I install Code Flow Visualizer in Claude Code?

Run `npx skills add wentorai/research-plugins --skill code-flow-visualizer -a claude-code`. Or copy the skill folder (skills/tools/diagram/code-flow-visualizer in wentorai/research-plugins) into .claude/skills/code-flow-visualizer in your project. Claude Code loads it when a task matches its description.

How do I install Code Flow Visualizer in Codex?

Run `npx skills add wentorai/research-plugins --skill code-flow-visualizer -a codex`. Or copy the skill folder (skills/tools/diagram/code-flow-visualizer in wentorai/research-plugins) into .agents/skills/code-flow-visualizer in your project. Codex loads it when a task matches its description.

Can I use Code Flow Visualizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill code-flow-visualizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-flow-visualizer, .gemini/skills/code-flow-visualizer, .github/skills/code-flow-visualizer and .opencode/skills/code-flow-visualizer in your project.

What does Code Flow Visualizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Code Flow Visualizer is instructions for the agent only. Our summary lists: Python 3.

Does Code Flow Visualizer access the network?

SKILL.md names 3 domains. As links in the text: github.com, mermaid.js.org and docs.python.org. This is read from the text; nothing was executed.

Is Code Flow Visualizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Code Flow Visualizer use?

Code Flow Visualizer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Flow Visualizer use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Flow Visualizer?

Skills that share tags, products or a category with Code Flow Visualizer: Code To Chart (rongxinzy/RongxinAI, 154 stars), CodeScope Codebase Graph Analysis (QwenLM/qwen-code, 28k stars), Generating Documentation (ancoleman/ai-design-components, 526 stars) and Microsim Generator (dmccreary/ibook-skills, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Flow Visualizer?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 428 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.