visualize

Convert CasaFlow stage markdown artifacts into self-contained HTML views.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CasaPerks/casaflow --skill visualize-casaperks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visualize
Source: https://github.com/CasaPerks/casaflow/tree/main/core/skills/visualize
Command: npx skills add https://github.com/CasaPerks/casaflow --skill visualize-casaperks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dense, long markdown artifacts are hard to absorb quickly, so developers keep getting stuck and lose momentum during comprehension gates.

Core Features & Use Cases

  • Generates derived, human-friendly HTML views from CasaFlow stage markdown while keeping the markdown as the canonical source of truth.
  • Supports stage-appropriate rendering for ticket, spec, plan, shipped, and QA artifacts using a consistent interactive layout.
  • Uses comprehension gating where it matters (prediction-before-reveal for forward-looking docs) and removes it for reviewer/after-the-fact docs (shipped/QA).
  • Opens the result in your browser so you can read in a better posture and return to the terminal to continue the workflow.

Quick Start

Run visualize on your saved artifact, then confirm you want the HTML rendered and open the output in your browser to review it before continuing.

Frequently Asked Questions about visualize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert stage markdown artifacts to readable HTML for easier review?

Converting stage markdown to HTML involves processing artifacts like ticket.md or spec.md into a single self-contained HTML file. This derived view opens in your browser for better readability while keeping the markdown as the canonical source.

What is prediction-before-reveal behavior for forward-looking markdown documents?

Prediction-before-reveal is a comprehension gating mechanism for forward-looking documents like spec or plan markdown. It hides certain content until you actively engage, ensuring you fully process the information before seeing the revealed details.

Does the markdown to HTML conversion work for QA review and shipped artifacts?

Yes, the markdown to HTML conversion supports QA review and shipped artifacts. It removes comprehension gating for these after-the-fact reviewer documents, presenting the content in a consistent interactive layout for quick absorption.

Can I pause the workflow to review generated HTML before proceeding?

Yes, the workflow supports explicit opt-in invocation with readiness pausing. After the HTML renders and opens in your browser, the workflow pauses so you can review the ticket or spec markdown output before returning to the terminal to continue.

What is the best way to handle dense markdown files that cause comprehension bottlenecks?

The best way to handle dense markdown bottlenecks is to generate derived, human-friendly HTML views. This transforms long artifacts into a consistent interactive layout, allowing you to read in a better browser posture and regain workflow momentum.

Are there limitations when using derived HTML views for spec workflow markdown?

The primary constraint is that derived HTML views are read-only representations; the original markdown remains the canonical source of truth. You must still edit the underlying markdown files to update the content before regenerating the HTML.