report-paradigm

Enforces centralized task report governance with chaptered documents and multi-page HTML report paradigms.

10|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill report-paradigm-cynthia1070711
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report-paradigm
Source: https://github.com/Cynthia1070711/PHYCOOL_Tools/tree/main/config-templates/claude/skills/report-paradigm
Command: npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill report-paradigm-cynthia1070711

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Multi-session tasks accumulate scattered progress, completion, and handoff reports across folders, causing information drift, duplication, and loss. This Skill enforces a single-source-of-truth report structure so every task maintains one master plan with chaptered documents instead of ever-growing piles of standalone report files. ## Core Features & Use Cases - Centralized Report Governance: All reports for a task live in one folder with a 00-master-plan document plus numbered chapter documents; updates merge into existing chapters rather than creating new files. - Safe Consolidation and Deletion Flow: A five-step process (inventory, build skeleton, deep-merge content, grep-verify before deletion, archive to _archive) prevents information loss when consolidating scattered legacy reports. - HTML Report Paradigms: Multi-page architecture with a single index entry and shared report-assets (css/js/pages), Mermaid diagrams via CDN, and a six-element module overview card specification (number, name, three tag groups, description, notes, update time) with equal-height cards. - Use Case: When finishing a project phase, update the corresponding chapter document and its HTML page instead of writing a new dated completion report; when inheriting a messy task folder, consolidate 25+ scattered reports into the master-plan structure with zero content loss. ## Quick Start Ask the AI to produce or update a task progress report following the report-paradigm discipline, merging it into the existing chapter document rather than creating a new file.

Frequently Asked Questions about report-paradigm

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

FAQPage Schema
How do I consolidate scattered task reports into one document?

Follow the five-step safe consolidation flow: inventory all scattered report files, build a master-plan-plus-chapters skeleton, deep-read and merge each file's key content into chapters, grep-verify representative content exists in the master document, then move originals to an _archive folder.

How should I structure HTML reports with multiple pages?

Keep only one index HTML at the root and place all chapter pages under report-assets/pages with shared css and js files. Never embed duplicated style or script blocks in individual pages; use relative paths and cross-page navigation.

What are the six required elements of a module overview card?

Each card needs a sequential number badge, a name with module code suffix, three tag groups (type, correction stage, development status) with timestamps on event tags, a description of five lines or fewer, notes of three lines or fewer, and a last-updated time, with all cards equal height.

Can I create a new report file for each project phase?

No. New phase results must be merged into the existing chapter document as milestone or version-history subsections. Creating separate dated report files for each phase is explicitly forbidden to prevent drift and duplication.

When should files be deleted versus archived during consolidation?

Files should only be removed after grep-verifying their key content exists in the master document. Gitignored files must always be moved to _archive rather than truly deleted, since their deletion is irreversible.