What is weekly-reports?

This Claude skill automates the creation and maintenance of professional weekly project reports integrated with Cumulative Flow Diagrams (CFD). It streamlines project oversight by automatically aggregating task data, calculating essential Agile metrics—such as throughput, lead time, and Work-In-Progress (WIP)—and generating visual Markdown reports to enhance team transparency and workflow efficiency.

When should I use weekly-reports?

weekly-reports is useful in the following scenarios: • Automated Progress Tracking: Generate weekly status summaries that automatically collect completed tasks and visualize the project's trajectory using CFDs. • Agile Workflow Optimization: Identify project bottlenecks and monitor team velocity by analyzing throughput and lead time metrics directly within the generated reports. • Stakeholder Reporting: Create structured Markdown reports and visual data charts to provide stakeholders with clear, data-driven insights into backlog status and delivery timelines. • Historical Data Analysis: Maintain a consistent record of project performance using JSON-based data storage for long-term trend analysis and process improvement.

name	weekly-reports
description	Génération et mise à jour de rapports hebdomadaires avec CFD (Cumulative Flow Diagram). Activer ce skill quand l'utilisateur parle de récapitulatif, bilan hebdomadaire, rapport de la semaine, ou CFD.
version	1.0.0

Weekly Reports Skill

Système de génération de rapports hebdomadaires pour le suivi des tâches du projet CV.

Available Commands

report-create

Crée un nouveau rapport hebdomadaire complet avec CFD.

report-create [--week YYYY-WNN]

Fonctionnalités:

Collecte automatique des tâches terminées/créées de la semaine
Génération du CFD (Cumulative Flow Diagram)
Création du rapport markdown
Statistiques par catégorie

Voir workflows/report-create.md pour les détails.

report-update

Met à jour un rapport existant (données, CFD, notes).

report-update [--week YYYY-WNN]

Fonctionnalités:

Mise à jour des données JSON
Régénération du CFD
Ajout de notes et observations

Voir workflows/report-update.md pour les détails.

Architecture

.claude/skills/weekly-reports/
├── SKILL.md                    # Ce fichier (Level 1)
└── workflows/                  # Instructions détaillées (Level 2)
    ├── report-create.md
    └── report-update.md

scripts/reports/                # Module Python (Level 3)
├── __init__.py
├── cfd.py                      # Génération CFD
├── weekly_report.py            # Génération rapport markdown
├── generate_cfd.py             # CLI
└── tests/                      # 34 tests

.tasks/reports/                 # Rapports générés
├── YYYY-WNN-recap.md           # Rapport markdown
├── YYYY-WNN-cfd.png            # Image CFD
└── YYYY-WNN-data.json          # Données brutes

Métriques du CFD

Le Cumulative Flow Diagram permet de visualiser:

Métrique	Lecture	Signification
Throughput	Pente de la zone verte	Vitesse de livraison (tâches/jour)
WIP	Épaisseur de la zone orange	Travail en cours
Lead Time	Distance horizontale	Temps moyen de traitement
Backlog	Hauteur de la zone bleue	Tâches restantes

Commandes CLI

# Générer un CFD depuis données JSON
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --output .tasks/reports/

# Afficher les métriques
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --metrics

# Mode interactif (afficher le graphique)
uv run --with matplotlib --with numpy scripts/reports/generate_cfd.py \
  --data .tasks/reports/2025-W48-data.json \
  --show

Format des données JSON

{
  "week": "2025-W48",
  "title": "Cumulative Flow Diagram - Semaine 48",
  "data": [
    {"date": "2025-11-24", "backlog": 29, "in_progress": 0, "done": 12, "comment": "État initial"},
    {"date": "2025-11-25", "backlog": 22, "in_progress": 0, "done": 32, "comment": "20 terminées"}
  ],
  "summary": {
    "tasks_completed": 28,
    "tasks_created": 19,
    "avg_wip": 0.5
  }
}

weekly-reports

When & Why to Use This Skill

Use Cases