← Back to Skills Marketplace
415
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install visual-explainer-openclaw
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 be what it says — a local HTML diagram/review generator — but it includes two behaviors you should explicitly accept before installing:
- In-place edits: Several prompts (fact-check, plan/diff reviews) instruct the agent to modify project files directly. If you don't want automated edits, run the skill in a read-only clone or ask it to produce suggested edits instead of applying them.
- Sharing to Vercel: The 'share' workflow and changelog claim zero-friction Vercel deployments. Inspect scripts/share.sh (and any 'vercel-deploy' helper) before running to confirm where content is uploaded and whether credentials or external accounts are used. Treat the share workflow as an explicit action that may publish potentially sensitive content.
Other practical checks:
- Review scripts/share.sh and any small helper scripts for network calls or third-party endpoints before using the share command.
- If you plan to let the agent run git commands and read your repository, run the skill in a disposable clone or sandbox until you’re comfortable.
- If you don't want external image generation, ensure the environment lacks the optional 'surf' CLI or confirm the CLI's invocation is what you expect.
If you want, I can (1) summarize exactly where the prompts ask to write files or make network requests, (2) show the content of scripts/share.sh for inspection, or (3) suggest safer invocation patterns (e.g., produce diff patches instead of writing files, or require explicit confirmation before share deployments).
Capability Analysis
Type: OpenClaw Skill
Name: visual-explainer-openclaw
Version: 0.5.1-openclaw.1
The 'visual-explainer' skill bundle is a comprehensive tool for generating HTML-based technical visualizations, diagrams, and slide decks. It provides the agent with detailed instructions (SKILL.md) and templates to produce high-quality visual outputs instead of standard text or ASCII. While the bundle includes a script for sharing files via Vercel (scripts/share.sh) and instructions for the agent to proactively use the 'write' and 'exec' tools to manage and open generated files, these behaviors are well-documented and strictly aligned with the skill's purpose. No indicators of malicious intent, such as secret theft or unauthorized persistence, were detected.
Capability Assessment
Purpose & Capability
The name/description match the files and prompts: the skill generates self-contained HTML diagrams, slide decks, and visual reviews. Asking the agent to read source files, run git commands, and produce HTML files is coherent with the advertised purpose. One notable capability that goes beyond mere rendering: several prompts (fact-check, diff-review, plan-review) explicitly instruct the agent to edit project files in place and to write corrections back to the repository. That behavior is powerful but explainable for a fact-check/diff-review skill — surface it to the user.
Instruction Scope
The SKILL.md and prompt templates instruct the agent to run git commands, read many local files (project source, docs, agent memory under ~/.openclaw/workspace/memory/...), and in some workflows to make direct edits to original files (fact-check.md: 'Correct in place' / 'Write corrections to the original file'). They also include a 'share' workflow that deploys generated pages to Vercel (external hosting). Reading and editing local repo files is consistent with code-review tasks, but automatic in-place edits and third-party uploads are significant side-effects that should be disclosed to users and gated.
Install Mechanism
This is instruction- and file-backed; there is no install spec that downloads or executes remote archives. The README and SKILL.md suggest optional git clone steps and refer to the original GitHub repo; those are normal for manual install. No high-risk download URLs or archive extraction are present in the manifest.
Credentials
The skill declares no required environment variables or credentials, which is consistent with its core functionality. However, optional behaviors reference external tools/services (the surf CLI for image generation and a 'vercel-deploy' helper script). The changelog and prompts mention a zero-auth Vercel deploy behavior (''no account or authentication required'') — if true, that implies uploading user content to a third-party account and is not declared in requires.env, which is a proportionality concern and should be validated.
Persistence & Privilege
The skill does not request always:true and is user-invocable; it writes files to a local workspace path (~/.openclaw/workspace/diagrams/) which is consistent with generating HTML artifacts. The bigger persistence concern is the skill's instruction to edit repository files in place (fact-check), and the optional share script that would make artifacts externally accessible. Neither of these are 'always' privileges, but they are capabilityful and should be authorized by the user.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install visual-explainer-openclaw - After installation, invoke the skill by name or use
/visual-explainer-openclaw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.1-openclaw.1
Initial OpenClaw adaptation of nicobailon/visual-explainer. Generate beautiful HTML pages and slide decks instead of ASCII art. Full attribution to original author.
Metadata
Frequently Asked Questions
What is Visual Explainer for OpenClaw?
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 415 downloads so far.
How do I install Visual Explainer for OpenClaw?
Run "/install visual-explainer-openclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Visual Explainer for OpenClaw free?
Yes, Visual Explainer for OpenClaw is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Visual Explainer for OpenClaw support?
Visual Explainer for OpenClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Visual Explainer for OpenClaw?
It is built and maintained by Ric Lewis (@keylimesoda); the current version is v0.5.1-openclaw.1.
More Skills