skills.rest
wangwu-30
wangwu-30COMMUNITY
Explore all skills by this author →
WebsiteGitHub

repo-alive

Transform code repositories into evidence-grounded knowledge graphs for architecture Q&A.

Updated Apr 13, 2026
Search Tags:#codebase analysis#architecture explorer#evidence-grounded qa#uncertainty-reduction#git fingerprinting#local html canvas
One-click install
npx skills add https://github.com/wangwu-30/ww-skills --skill repo-alive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-alive
Source: https://github.com/wangwu-30/ww-skills/tree/main/repo-alive
Command: npx skills add https://github.com/wangwu-30/ww-skills --skill repo-alive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ws, node>=18, npm, lsof, python3.

What problem does it solve?

repo-alive removes the friction of understanding unfamiliar codebases by building evidence-grounded manifests and then enabling a grounded Q&A experience over real files.

Core Features & Use Cases

  • Uncertainty-reduction codebase analysis: performs wide search, hypothesis generation, verification, and writes structured outputs into .repo-alive/ for reuse.
  • Grounded TUI Q&A: answers questions using manifests plus source file content, with file:line citations.
  • Optional experimental HTML canvas: renders an interactive architecture/scenario explorer via a local server (requires Node.js).

Quick Start

Run /repo-alive to analyze the current repository (if needed) and then ask questions about how it works in a persistent TUI grounded in real source files.

Frequently Asked Questions about repo-alive

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

FAQPage Schema
How do I explore an unfamiliar codebase architecture without manually reading source files?▼

To explore an unfamiliar codebase architecture, this Skill builds evidence-grounded knowledge graphs from repository files and provides grounded Q&A with file:line citations, eliminating manual source reading.

Can I ask "what-if" scenario questions about how modules interact across a repository?▼

Yes, you can ask "what-if" scenario questions about module interactions. The Skill applies targeted reasoning across services and modules using generated hypotheses and verified source evidence.

What dependencies do I need to run codebase analysis and generate a local HTML canvas?▼

To run codebase analysis and generate the HTML canvas, you need Node.js version 18 or higher, npm, Python3, lsof, and the ws package installed in your environment.

How does evidence-grounded Q&A reduce uncertainty when understanding a codebase?▼

Evidence-grounded Q&A reduces uncertainty by performing wide searches and hypothesis verification, then answering questions using manifests plus actual source file content with precise file:line citations.

Does repo-alive track git changes to keep codebase exploration manifests fresh?▼

Yes, repo-alive tracks git changes by using git-head freshness tracking with persisted manifests written into the .repo-alive/ directory, ensuring codebase exploration outputs remain current.

Is there a terminal interface for asking questions about my codebase behavior?▼

Yes, there is a persistent terminal-based interface for grounded Q&A that answers questions about your codebase behavior using source file content and structured manifest outputs.

Related Skills

Explore More Software Engineering Skills→
wipcomputerwipcomputer
3

wip-repos

Reconcile repository filesystem layout with a central manifest file.

Official
Intermediate
RdindaRdinda
1

reversa-docs-mapper

Generate 3D and 2D architecture visualizations from cached module and dependency JSONs.

Community
Advanced
asnar00asnar00
1

py-stop-local

Stop a local Flask server on port 8080 using PID file or lsof.

Community
Intermediate
paxlabs-incpaxlabs-inc
7

technical-architecture-proposal

Generate technical architecture proposals from codebase analysis and seam-finding.

Community
Advanced