docs-html-project-viewer

Serve a single-file HTML dashboard visualizing repository state across backlog, stories, and risks.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill docs-html-project-viewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-html-project-viewer
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/docs-html-project-viewer
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill docs-html-project-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a concise, single-view dashboard that eliminates the need to open many repository files to understand current project status, backlog progress, tests, reports, open questions, and risks. It surfaces execution-plan state, review gates, and MCP/ runtime posture so teams can re-enter work from an explicit machine-readable snapshot instead of guessing from scattered artifacts.

Core Features & Use Cases

  • Single-file HTML viewer with embedded CSS/JS that requires no frontend build step and runs a lightweight local server.
  • Auto-refreshing JSON endpoint polled by the page every 10 seconds, client-side routing, cross-links between IDs, hover summaries, phase progress bar, and runtime posture display.
  • Use cases: product reviews, stakeholder status demos, developer on-boarding, and rapid traceability checks across backlog, docs, tests, and execution-plan reports.

Quick Start

Launch the project viewer by running the project_viewer.py script from the skill directory with a chosen port to open the live dashboard in your browser.

Frequently Asked Questions about docs-html-project-viewer

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

FAQPage Schema
How do I visualize repository backlog and traceability in a live dashboard?

A live HTML dashboard visualizes repository state across backlog, stories, execution plans, tests, reports, and risks with cross-links and hover details. It runs a lightweight local server and requires no frontend build step, consolidating scattered artifacts into a single-file viewer.

Can I auto-refresh project status data without a complex frontend framework?

You can auto-refresh project status without a frontend framework by polling a lightweight JSON endpoint every 10 seconds. The single-file HTML viewer embeds CSS and JS, updating execution-plan state and runtime posture dynamically without external build dependencies.

Does the local HTML dashboard support cross-links between backlog items and test reports?

The local HTML dashboard supports cross-links between backlog items and tests by resolving artifact IDs within the page. Client-side routing and hover summaries enable rapid traceability checks across documentation and execution-plan phases.

What's the best way to set up a single-file project viewer for stakeholder status demos?

Run the project viewer script with a chosen port from the skill directory to open a live HTML dashboard for stakeholder demos. It displays phase progress bars and runtime posture, eliminating the need to open multiple repository files to communicate status.

Are there limitations to using a dependency-light HTML dashboard for project reporting?

A dependency-light HTML dashboard for project reporting requires a local server and Python to run the viewer script. Designed for local development and review scenarios, it provides auto-refresh and cross-links but is not built for continuous cloud-hosted monitoring.