← Back to Skills Marketplace
Visual Explainer Main
by
austindixson
· GitHub ↗
· v1.0.0
347
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install visual-explainer-main
Description
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architectur...
Usage Guidance
This skill appears to do what it says (generate styled HTML reviews and diagrams), but review these points before installing:
- The prompts expect to run git and gh commands and to read/write files under your home directory (e.g., ~/.agent/diagrams/, ~/.agent/memory/, ~/.pi/agent/memory/). The registry entry did not declare these config/path dependencies — confirm you are comfortable with the skill reading project files and agent memory.
- Optional image generation uses surf-cli/Gemini if present; that path may require API keys or external network access. If you don't want external image calls, ensure surf-cli is not installed or restrict the agent's network access.
- There is a small Python script included (scripts/generate_header.py). Inspect any bundled scripts before executing them. Because there's no install step, the agent might still execute local code depending on how your agent platform runs skills — verify the platform's execution model.
- If you plan to use diff-review/plan-review/fact-check, test the skill in a sandbox repository first (no secrets, small sample repo) to confirm behavior.
- If you need assurance: ask the skill author for a short list of required binaries (git, gh, surf), explicit config paths the skill reads/writes, and a confirmation of what (if anything) is sent externally when surf is invoked. If unsure, decline installation or restrict the agent's file and network permissions.
Capability Analysis
Type: OpenClaw Skill
Name: visual-explainer-main
Version: 1.0.0
The visual-explainer skill bundle is a legitimate tool designed to generate technical diagrams and HTML reports from codebase analysis. It gathers data using standard shell commands (git, grep, wc) and renders visualizations using reputable CDN-hosted libraries like Mermaid.js and Chart.js. The Python script (generate_header.py) uses proper HTML escaping, and the prompt templates are focused on technical accuracy and visual hierarchy without any evidence of data exfiltration, persistence mechanisms, or malicious prompt injection.
Capability Assessment
Purpose & Capability
The skill's name and description align with generating HTML diagrams and visual reviews. However, SKILL.md and the prompt templates repeatedly assume access to git, the GitHub CLI (`gh`), the surf-cli/Gemini image pipeline, and to write/read paths under the user's home (e.g., ~/.agent/diagrams/, ~/.agent/memory/, ~/.pi/agent/memory/). The registry metadata declared no required binaries or config paths, so the skill's declared requirements understate what it actually expects to use.
Instruction Scope
Runtime instructions direct the agent to run many local shell commands (git diff, git show, grep, wc, gh pr diff, which surf), read entire changed files, and probe agent memory files (~/.agent/memory/*, ~/.pi/agent/memory/*). They also instruct writing files to ~/.agent/diagrams/ and opening them in a browser. Reading agent memory and arbitrary project files is powerful and privacy-sensitive; those accesses are within the stated purpose (code/plan/diff review) but are not explicitly declared in the skill metadata and merit user awareness.
Install Mechanism
There is no install spec (instruction-only) which is lower-risk, but the package includes a Python script (scripts/generate_header.py). The SKILL.md doesn't instruct running that script, but an agent or user could execute it — review the script before running. No external archives or untrusted downloads are used.
Credentials
The skill declares no required environment variables or credentials, yet its optional image generation path (surf-cli + Gemini) and the use of `gh` may implicitly require credentials or network access. The prompts also reference various home-dir paths (agent memory) that grant access to potentially sensitive conversation history — this level of local access should be explicitly documented and authorized by the user.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills. It writes output to ~/.agent/diagrams/ and opens files in the browser — expected for a renderer. Autonomous invocation is allowed (platform default) but not combined here with other high-risk flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install visual-explainer-main - After installation, invoke the skill by name or use
/visual-explainer-main - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of visual-explainer: generate styled, self-contained HTML pages for technical visualizations and data tables.
- Creates HTML diagrams and tables instead of ASCII art for complex or tabular technical content.
- Offers a range of visual aesthetics (blueprint, neon, editorial, hand-drawn, and more).
- Automatically generates HTML pages for tables with 4+ rows or 3+ columns.
- Integrates with Mermaid and Chart.js for various diagram types and dashboard layouts.
- Adds zoom controls to Mermaid diagrams by default for usability.
- Supports optional AI-generated images via surf-cli for enhanced visuals.
- Includes detailed workflow and styling guidance to ensure clear, varied, and accessible outputs.
Metadata
Frequently Asked Questions
What is Visual Explainer Main?
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architectur... It is an AI Agent Skill for Claude Code / OpenClaw, with 347 downloads so far.
How do I install Visual Explainer Main?
Run "/install visual-explainer-main" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Visual Explainer Main free?
Yes, Visual Explainer Main is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Visual Explainer Main support?
Visual Explainer Main is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Visual Explainer Main?
It is built and maintained by austindixson (@austindixson); the current version is v1.0.0.
More Skills