Flowthis
Turn conversations, documents, PDFs, research papers, repositories, architecture notes, product ideas, ads, user stories, debug timelines, PR summaries, or other context into polished FlowThis-owned self-contained HTML visuals. Use when the user says things like "visualize this", "make a FlowThis visual", "save this as a visual", "turn this document into a visual", "diagram this repo", "create a research paper visual", or runs /flowthis. Provides visual briefs, source-type routing, component recipes, evidence rails, no-JS interaction patterns, quality gates, and diagram guardrails when the user does not specify a layout.From its SKILL.md
npx -y skills add Mario-Vishal/flowthis-visual-skill --skill flowthisAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.0 KB, 973 tokens by cl100k_base, as published. Nobody here has run it
FlowThis: create a shareable visual
Your job is to transform the user's source material into one polished, self-contained HTML document.
1. Decide what to visualize
- If the user named a focus, use it.
- Otherwise classify the source type and choose the default FlowThis pattern.
Read
references/visualization-system.mdfor routing, component patterns, interaction rules, and diagram rules whenever the source is a document/PDF, research paper, repo, architecture, conversation history, product/ad, user-story workflow, or data report. - Start with a visual brief: source type, audience, confidence, reader job, primary insight, and what to inspect first.
- If the source is genuinely ambiguous, ask one short question.
- Keep the title short and specific.
- Add a source/provenance line when the visual is derived from a document, PDF, URL, repo, conversation, or meeting notes.
2. Generate the HTML
The HTML must be:
- A complete
<!doctype html>page with everything inline. - No JavaScript at all: no
<script>and no inline event handlers. - No external requests: no external stylesheets, fonts, remote images, or
iframes. Images, if any, must be
data:URIs. - Styled with inline CSS and inline SVG.
- Animated only with CSS or SVG, never JavaScript.
- Responsive and readable on mobile and desktop.
- Free of secrets, tokens, credentials, private keys, and raw private source.
- Source-specific in style. Do not force FlowThis's own product palette unless the source is FlowThis or the user asks for it.
- Depth is mandatory. The visual must teach the source's core logic, evidence, assumptions, tradeoffs, and implications. Do not ship a good-looking page that is only decorative, vague, or made of generic rectangular cards.
- Structured with stable section ids or
data-element-idattributes where comments would naturally attach. - Professionally attributed at the bottom with only the essentials:
Generated with FlowThis SkillandSource: <source>. Link the FlowThis text when the site URL is known. Do not put long generation notes in the attribution. - For repository/codebase visuals, build a deep architecture experience, not a shallow repo tour. Include a concise top summary, detailed module/file drill-downs, key flows, contracts, runtime/deploy notes, risks, and tests. The layout does not have to be an IDE. Use a literal IDE, wide architecture canvas, docs workspace, directory mock with file previews, or hybrid layout based on what explains the source best. If an IDE/window frame is used, expand it to the available width and make architecture diagrams large enough to read.
- Architecture visuals must not be plain rectangles connected by static lines. Use inline SVG/CSS icons, semantic node shapes, grouped boundaries, animated arrows/flow dots, and full-width diagrams. Keep all motion CSS/SVG-only and purposeful.
- For research papers/PDFs, build a technical reading companion: problem formulation, prior approach contrast, method mechanics, equations/algorithms when present, experiment/baseline/metric tables, tradeoff/ablation discussion, limitations, and as many focused diagrams as the paper needs.
Aim for something genuinely worth sharing, not a placeholder.
3. Apply the FlowThis quality gates
Before finishing, revise until all five gates are acceptable:
- Clarity: the first screen explains the artifact without the original prompt.
- Structure: the page has a primary reading path.
- Geometry: arrows stop at boundaries and do not collide with text.
- Evidence: source-backed facts and inferred summaries are distinguishable.
- Share polish: title, provenance, summary, primary visual, detail sections, and read-next area are present.
4. Save or hand off
If FlowThis MCP tools are available:
- Optionally call
list_groupsif the user wants a folder. - Call
create_visualizationwithtitleandhtml. - Share the returned URL.
- For revisions, read feedback with
get_visualization_suggestions, fetch the current HTML withget_visualization, and publish a new version withcreate_visualization_version.
If FlowThis MCP tools are not available:
- Write the document to
flowthis-visual.htmlin the working directory. - Tell the user they can preview it locally and upload it manually to FlowThis.
Do not dump the full HTML into chat unless asked.
What ships with it: 2 files
21.1 KB alongside SKILL.md
agents/
- openai.yaml269 B
references/
- visualization-system.md20.8 KB