skills.rest
sandeco
sandecoCOMMUNITY
Explore all skills by this author →
Website𝕏@sandecoGitHub

reversa-debugger-graph

Validates bug.md files and regenerates bug catalogs, mermaid graphs, and traceability matrices.

1.5k|405|Updated Apr 26, 2026
Search Tags:#Mermaid#traceability#Markdown#triage#bug tracking#Validation#graph generation
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-debugger-graph
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-debugger-graph
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-debugger-graph
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-debugger-graph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a project accumulates dozens of bug records across multiple contexts, no one can see the big picture without reading every file. This Skill scans all bug.md files, validates their invariants, and deterministically regenerates index, catalog, relationship matrix, mermaid graph, HTML graph view, and BUG-to-SPEC traceability views.

Core Features & Use Cases

  • Invariant Validation: Globally checks all bug front matter for duplicate IDs, unknown schema versions, invalid resolution states, broken relations, and inconsistent DONE.md locks, reporting errors instead of silently fixing them.
  • Deterministic View Generation: Regenerates catalog.jsonl, index.md, matrix.md, graph.md, a self-contained dark-theme graph.html with clickable nodes, and spec-matrix.md per context, plus a spec-side traceability mirror.
  • Impact Scoring and Clustering: Computes an impact score per open bug from confirmed relationship edges and identifies bug clusters converging on the same component to guide triage.
  • Use Case: After a merge introduces duplicate bug IDs across branches, run this Skill to detect the conflicts, regenerate all bug dashboards for valid records, and get a report listing every inconsistency for human decision.

Quick Start

Ask the agent to run the reversa-debugger-graph skill to validate all bug records and regenerate the bug graph views for every context.

Frequently Asked Questions about reversa-debugger-graph

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

FAQPage Schema
How do I generate a bug relationship graph from markdown bug records?▼

Run this Skill to scan all bug.md front matter, validate relations, and regenerate a mermaid graph in graph.md plus a self-contained graph.html with clickable nodes. Confirmed relations render as solid edges and proposed hypotheses as dashed edges.

How to validate bug tracking files for duplicate IDs after a branch merge?▼

The Skill performs global invariant validation across all contexts, detecting duplicate IDs, unknown schema versions, broken relations, and cycles in duplicate-of links. Errors are listed explicitly in the report and never fixed silently.

Does this bug graph generator modify the original bug records?▼

No, bug.md files are strictly read-only for this Skill. It writes only to the generated views folder and the spec traceability mirror, and any inconsistency is reported for human decision rather than corrected automatically.

Can I regenerate views for only one bug context instead of all?▼

Yes, passing a context name as an argument regenerates views only for that context. Without an argument, the Skill processes every context folder found under the bugs directory one by one.

What happens to restricted-visibility bugs in the generated views?▼

Bugs marked with restricted visibility appear only as an ID labeled restricted in the index, with no title or details. They are excluded entirely from the graph, HTML view, and the spec-side traceability mirror.

Related Skills

Explore More Software Engineering Skills→
kipeum86kipeum86

ingest

Convert inbox source files to Markdown with grading and metadata.

Community
Advanced
fernandoxavier02fernandoxavier02

superpower-debugging

Trace bugs to root causes using a four-phase debugging workflow.

Community
Advanced
Pyl-TechPyl-Tech

spec-gate

Verify implementation specs are complete and actionable before AI coding begins.

Official
Advanced
devopstalesdevopstales
1

skillgrid-issue-creation

Create and link external tracker issues for Skillgrid work items.

Community
Advanced