skills.rest
ozand
ozandCOMMUNITY
Explore all skills by this author →
GitHub

kb-visualize

Generate an interactive HTML graph visualization of knowledge base lessons.

Updated Jun 22, 2026
Search Tags:#markdown#html#python#knowledge base#graph visualization#lesson graph#viz.html
One-click install
npx skills add https://github.com/ozand/knowledge-base-template --skill kb-visualize-ozand
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kb-visualize
Source: https://github.com/ozand/knowledge-base-template/tree/main/_template/skills/kb-visualize
Command: npx skills add https://github.com/ozand/knowledge-base-template --skill kb-visualize-ozand

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml.

What problem does it solve? When a knowledge base of error lessons grows, it becomes hard to see how lessons relate to each other. This Skill regenerates a self-contained interactive graph (viz.html) so you can visually explore lessons, categories, and cross-links without running a server. ## Core Features & Use Cases - Graph Generation: Runs the kb-generate-viz script to rebuild viz.html with nodes colored by category and sized by lesson length. - Edge Mapping: Draws edges from cross-links in each lesson's Related section, exposing how lessons reference one another. - Interactive Viewer: The output HTML supports search, filtering by type or category, and multiple layout options, all in a single file openable directly in a browser. - Use Case: After manually adding several new lessons to the KB, run this Skill to refresh viz.html and verify the graph structure looks correct. ## Quick Start Ask the agent to regenerate the KB visualization graph and report how many nodes and edges it contains.

Frequently Asked Questions about kb-visualize

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

FAQPage Schema
How do I generate a graph visualization of a markdown knowledge base?▼

Run the kb-generate-viz script against the KB root directory, for example kb-generate-viz ~/.pi/kb. It parses lesson files and their Related cross-links, then writes a self-contained viz.html you can open in any browser.

When should I regenerate the KB viz.html graph?▼

Regenerate it after manually adding or editing lessons outside the kb-capture flow, or after format changes, to verify the graph structure. The kb-capture skill already runs this automatically, so manual runs are only needed for edits made by hand.

Does the HTML graph visualization need a web server?▼

No, viz.html is a fully self-contained single-file HTML page. You can open it directly in a browser with a command like xdg-open, with no server or build step required.

What dependencies are required to build the knowledge graph HTML?▼

The generator requires Python 3 with PyYAML installed. If those are unavailable, uv is used automatically as a fallback to run the script.

What if kb-generate-viz is not found in PATH?▼

Invoke the script directly from the KB scripts directory, for example ~/.pi/kb/scripts/generate-viz.sh ~/.pi/kb. It produces the same viz.html output and prints node, edge, and file size counts.

Related Skills

Explore More Software Engineering Skills→
cuiosscuioss
4

manage-lessons

Create, update, query, and archive Markdown-based lesson notes across projects.

Official
Advanced
IgorGanapolskyIgorGanapolsky
25

search-lessons

Search Thumbgate lessons to retrieve corrective actions and linked enforcement rules.

Community
Basic
RussianLioNRussianLioN
1

lessons

Query and manage lessons learned from RCA reports by severity, tag, or category.

Community
Intermediate
samlinesamline

codebase-memory

Query a persistent knowledge graph for codebase structure, symbols, and dependencies.

Community
Intermediate