---

name: Generic Completion Report description: Generate completion reports from template for any project. Use when phase complete, milestone reached, or user says "create completion report" or "phase done". Ensures standardized project documentation and progress tracking. allowed-tools: Read, Write version: 1.0.0

Generic Completion Report

Purpose

Generate standardized completion reports for project phases, milestones, and deliverables using template-based approach.

When This Activates

• User says "phase complete", "create completion report", "phase done"
• User finishes implementation and says "finished", "complete"
• User attempts to start new phase without completing previous
• Milestone completion detected

Prerequisites

• Phase/milestone actually complete
• Deliverables implemented
• Testing completed

Configuration Required

Projects must provide:

• ${PROJECT_REPORT_PATH} - Where to save reports
• ${PROJECT_REPORT_FORMAT} - Report naming convention
• ${PROJECT_SECTIONS} - Required report sections (optional, defaults to standard 10)

---

Steps

Step 1: Check for Project Configuration

Load project-specific completion-report skill if exists in .claude/skills/completion-report/

Step 2: Load Report Template

Read templates/completion-report-template.md

Step 3: Gather Completion Information

Collect from user and codebase:

• Phase/milestone name
• Completion date
• Objectives achieved
• Deliverables completed
• Files modified/created
• Metrics (lines of code, tests, performance)
• Issues encountered and resolved
• Lessons learned
• Next steps

Step 4: Analyze Implementation

• Use Grep/Glob to identify files changed since phase start
• Check git log for commits during phase
• Identify test files added
• Calculate metrics

Step 5: Populate Template

Replace all placeholders with gathered information

Step 6: Write Report

If configured: Write to ${PROJECT_REPORT_PATH} Otherwise: Provide as text output

Step 7: Trigger Next Steps (if configured)

• May invoke master-plan-update skill
• May suggest starting next phase

---

Output

• Complete completion report document
• Written to file or provided as text
• Summary of achievements

---

Examples

See template for complete report structure

---

Changelog

Version 1.0.0 (2025-10-20)

• Initial release

---

End of Skill