RRepoGEO

REPOGEO REPORT · LITE

johnlindquist/mdflow

Default branch main · commit 11855495 · scanned 6/13/2026, 4:47:08 AM

GitHub: 594 stars · 41 forks

AI VISIBILITY SCORE
30 /100
Critical
Category recall
0 / 2
Not recommended in any query
Rule findings
1 pass · 0 warn · 1 fail
Objective metadata checks
AI knows your name
3 / 3
Direct prompts that named your repo
HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface johnlindquist/mdflow, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

2 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION
  • highreadme#1
    Reposition README opening to clarify purpose as CLI for executable AI prompts

    Why:

    CURRENT
    # mdflow

```bash
review.claude.md                 # Run with Claude
commit.gemini.md "fix auth bug"  # Run with Gemini
git diff | explain.claude.md     # Pipe through any command
```

**Your markdown files are now executable AI agents.## What Is This?
    COPY-PASTE FIX
    # mdflow: A CLI for Executable AI Prompts in Markdown

**mdflow transforms your markdown files into executable AI agents, allowing you to run prompts against Claude, Gemini, Codex, or Copilot directly from your command line.**

```bash
review.claude.md                 # Run with Claude
commit.gemini.md "fix auth bug"  # Run with Gemini
git diff | explain.claude.md     # Pipe through any command
```

## What Is This?
  • highlicense#2
    Add a LICENSE file to the repository

    Why:

    COPY-PASTE FIX
    Create a LICENSE file in the repository root with your chosen open-source license (e.g., MIT, Apache-2.0, GPL-3.0).

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall
0 / 2
0% of queries surface johnlindquist/mdflow
Avg rank
—
Lower is better. #1 = top recommendation.
Share of voice
0%
Of all named tools, what % are you?
Top rival
prefect-ai/marvin
Recommended in 1 of 2 queries
COMPETITOR LEADERBOARD
  1. prefect-ai/marvin · recommended 1×
  2. jupyter/notebook · recommended 1×
  3. jupyterlab/jupyterlab · recommended 1×
  4. langchain-ai/langchain · recommended 1×
  5. run-llama/llama_index · recommended 1×
  • CATEGORY QUERY
    How can I make AI prompts executable scripts directly from markdown files?
    you: not recommended
    AI recommended (in order):
    1. Marvin (prefect-ai/marvin)
    2. Jupyter Notebooks (jupyter/notebook)
    3. JupyterLab (jupyterlab/jupyterlab)
    4. langchain (langchain-ai/langchain)
    5. LlamaIndex (run-llama/llama_index)
    6. OpenAI
    7. Anthropic
    8. Quarto (quarto-dev/quarto-cli)
    9. Pandoc (jgm/pandoc)
    10. Emacs Org-mode (org-mode/org-mode)
    11. VS Code (microsoft/vscode)
    12. Code Runner (formulahendry/vscode-code-runner)
    13. markdown-it-py (executablebooks/markdown-it-py)
    14. mistune (lepture/mistune)

    AI recommended 14 alternatives but never named johnlindquist/mdflow. This is the gap to close.

    Show full AI answer
  • CATEGORY QUERY
    What command-line tool allows running markdown-based AI prompts against different language models?
    you: not recommended
    AI recommended (in order):
    1. LM Studio
    2. Ollama (ollama/ollama)
    3. LiteLLM (BerriAI/litellm)
    4. OpenAI CLI (openai/openai-python)
    5. Anthropic CLI (anthropics/anthropic-sdk-python)
    6. Hugging Face `transformers` library (huggingface/transformers)

    AI recommended 6 alternatives but never named johnlindquist/mdflow. This is the gap to close.

    Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

  • Metadata completeness
    fail

    Suggestion:

  • README presence
    pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

  • Compared to common alternatives in this category, what is the core differentiator of johnlindquist/mdflow?
    pass
    AI named johnlindquist/mdflow explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • If a team adopts johnlindquist/mdflow in production, what risks or prerequisites should they evaluate first?
    pass
    AI named johnlindquist/mdflow explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • In one sentence, what problem does the repo johnlindquist/mdflow solve, and who is the primary audience?
    pass
    AI named johnlindquist/mdflow explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of johnlindquist/mdflow. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

RepoGEO badge previewLive preview
MARKDOWN (README)
[![RepoGEO](https://repogeo.com/badge/johnlindquist/mdflow.svg)](https://repogeo.com/en/r/johnlindquist/mdflow)
HTML
<a href="https://repogeo.com/en/r/johnlindquist/mdflow"><img src="https://repogeo.com/badge/johnlindquist/mdflow.svg" alt="RepoGEO" /></a>
Pro

Subscribe to Pro for deep diagnoses

johnlindquist/mdflow — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

  • Deep reports10 / month
  • Brand-free category queries5 vs 2 in Lite
  • Prioritized action items8 vs 3 in Lite