compile-report

Compile scattered Markdown analysis reports into a single HTML document.

8|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/wfukatsu/refactoring-agent-for-claude-code --skill compile-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compile-report
Source: https://github.com/wfukatsu/refactoring-agent-for-claude-code/tree/main/.claude/skills/compile-report
Command: npx skills add https://github.com/wfukatsu/refactoring-agent-for-claude-code --skill compile-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill consolidates scattered Markdown analysis results into a single, polished HTML report, saving time and reducing manual handoffs.

Core Features & Use Cases

  • Automatic aggregation: Detects and combines all Markdown reports from the analysis pipeline into one HTML document.
  • Mermaid rendering: Renders Mermaid diagrams inline within the report.
  • GraphDB visualization: Embeds an interactive GraphDB visualization for data relationships.
  • Table of contents: Automatically generates a navigable sidebar and section index.
  • Theming and responsiveness: Provides light/dark themes and responsive layout for desktop and mobile.
  • Deduplication: Avoids duplicate files caused by inconsistent naming conventions.

Quick Start

Use the compile-report skill to convert your reports into a single HTML file.

  • Run: /compile-report --input-dir ./reports --output ./reports/00_summary/full-report.html --title "リファクタリング分析レポート"
  • Open the result: open reports/00_summary/full-report.html

Frequently Asked Questions about compile-report

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

FAQPage Schema
How do I compile multiple Markdown files into a single HTML report?

To compile multiple Markdown files into a single HTML report, you can use this Skill to automatically aggregate scattered analysis results, add a navigable sidebar, and output a single cohesive HTML document with responsive styling.

Does compiling Markdown to HTML support Mermaid diagram rendering?

Yes, compiling Markdown to HTML supports Mermaid diagram rendering. The Skill renders Mermaid diagrams inline within the final HTML document, requiring optional mermaid-cli alongside Python markdown libraries.

What do I need to convert Markdown analysis results into styled HTML?

To convert Markdown analysis results into styled HTML, you need Python 3.9+ with markdown and pymdown-extensions installed. Optional mermaid-cli is required if you need inline Mermaid diagram rendering.

Can I embed GraphDB visualizations when generating an HTML report from Markdown?

Yes, you can embed GraphDB visualizations when generating an HTML report from Markdown. The Skill embeds interactive GraphDB visualizations to display data relationships directly within the output document.

How do I avoid duplicate files when aggregating Markdown reports?

To avoid duplicate files when aggregating Markdown reports, the compilation process includes automatic deduplication. It identifies and skips redundant files caused by inconsistent naming conventions during HTML generation.

What is the best way to generate a navigable HTML report from scattered analysis files?

The best way to generate a navigable HTML report from scattered analysis files is using an automated compiler that builds a sidebar index. It applies light and dark themes with responsive layouts for desktop and mobile viewing.