Back to Skills

generate-status-report

pjt222
Updated 2 days ago
2 views
17
2
17
View on GitHub
Metadata

About

This skill generates a project status report by analyzing existing artifacts like the charter, backlog, and sprint plans to calculate metrics, identify blockers, and summarize progress with RAG indicators. It is designed for use at the end of a sprint, before governance meetings, or when new risks emerge. Key capabilities include automated metric calculation and RAG status assessment for schedule, scope, budget, and quality.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/generate-status-report

Copy and paste this command in Claude Code to install this skill

Documentation


name: generate-status-report description: > Einen Projektstatusbericht erstellen durch Lesen vorhandener Artefakte (Charter, Backlog, Sprint-Plan, PSP), Berechnen von Kennzahlen, Identifizieren von Blockaden und Zusammenfassen des Fortschritts mit RAG-Indikatoren fuer Zeitplan, Umfang, Budget und Qualitaet. Verwenden am Ende eines Sprints oder Berichtszeitraums, wenn Stakeholder ein Gesundheitsupdate anfragen, vor Steuerungsausschuss- oder Governance-Sitzungen oder wenn eine neue Blockade oder ein Risiko mitten im Projekt auftaucht. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: project-management complexity: intermediate language: multi tags: project-management, status-report, metrics, rag, progress, blockers locale: de source_locale: en source_commit: 6f65f316 translator: claude-opus-4-6 translation_date: "2026-03-16"

Projektstatusbericht erstellen

Einen periodischen Statusbericht erstellen, indem Projektartefakte analysiert, Fortschrittskennzahlen berechnet und Leistungen, Blockaden und bevorstehende Arbeit mit RAG-Gesundheitsindikatoren (Rot/Gelb/Gruen) zusammengefasst werden.

Wann verwenden

  • Ende eines Sprints oder Berichtszeitraums (woechentlich, zweiwochentlich, monatlich)
  • Stakeholder-Anfragen nach einem Projektgesundheitsupdate
  • Vor Steuerungsausschuss- oder Governance-Sitzungen
  • Wenn sich Projektgesundheitsindikatoren aendern (z.B. neue Blockade oder Risiko taucht auf)
  • Periodischer Checkpoint gegen Charter-Meilensteine

Eingaben

  • Erforderlich: Berichtszeitraum (Startdatum, Enddatum)
  • Erforderlich: Mindestens ein Projektartefakt (BACKLOG.md, SPRINT-PLAN.md, WBS.md oder PROJECT-CHARTER.md)
  • Optional: Vorherige Statusberichte (fuer Trendvergleich)
  • Optional: Budget- oder Ressourcentracking-Daten
  • Optional: Risikoregister-Aktualisierungen

Vorgehensweise

Schritt 1: Vorhandene Artefakte lesen

Das Projektverzeichnis nach PM-Artefakten durchsuchen:

  • PROJECT-CHARTER.md — Meilensteine, Erfolgskriterien
  • BACKLOG.md — Eintragsanzahlen nach Status, Burn-down-Daten
  • SPRINT-PLAN.md — Sprint-Ziel, zugesagte Eintraege, Aufgabenabschluss
  • WBS.md — Abschlussprozentzahlen von Arbeitspaketen
  • Vorherige STATUS-REPORT-*.md-Dateien — Trenddaten

Verfuegbare Dateien lesen. Nicht alle werden vorhanden sein — den Bericht an verfuegbare Daten anpassen.

Erwartet: Mindestens ein Artefakt erfolgreich gelesen, Schluesseldaten extrahiert.

Bei Fehler: Wenn keine Artefakte vorhanden sind, kann kein Bericht erstellt werden. Zuerst eine Charter oder einen Backlog mit den Skills draft-project-charter oder manage-backlog erstellen.

Schritt 2: Fortschrittskennzahlen berechnen

Kennzahlen aus verfuegbaren Daten berechnen:

Agile Kennzahlen (aus BACKLOG.md / SPRINT-PLAN.md):

  • Velocity: in diesem Sprint abgeschlossene Story Points
  • Sprint-Abschluss: erledigte Eintraege / zugesagte Eintraege
  • Backlog-Burn-down: verbleibende Gesamtpunkte vs. vorherigem Zeitraum
  • Durchlaufzeit: durchschnittliche Tage von In Progress bis Done

Klassische Kennzahlen (aus WBS.md):

  • % abgeschlossen: erledigte Arbeitspakete / Gesamtarbeitspakete
  • Zeitplanabweichung: geplante Meilensteindaten vs. tatsaechliche
  • Aufwandsabweichung: geschaetzter Aufwand vs. tatsaechlich verbrauchter Aufwand
## Metrics
| Metric | Value | Previous | Trend |
|--------|-------|----------|-------|
| Velocity | [N] pts | [N] pts | ↑/↓/→ |
| Sprint Completion | [N]% | [N]% | ↑/↓/→ |
| Backlog Remaining | [N] pts | [N] pts | ↓ (good) |
| Schedule Variance | [+/-N days] | [+/-N days] | |

Erwartet: 3-5 Kennzahlen berechnet mit Vergleich zum Vorjahreszeitraum.

Bei Fehler: Wenn keine historischen Daten vorhanden sind (erster Bericht), die Spalten "Previous" und "Trend" weglassen. Wenn Daten unvollstaendig sind, Luecken in der Berichtsfussnote mit Massnahmen zur Etablierung des Trackings vermerken.

Schritt 3: Blockaden, Risiken und Probleme identifizieren

Aktive Blockaden und Risiken auflisten:

## Blockers & Risks
| ID | Type | Description | Severity | Owner | Status | Action Required |
|----|------|------------|----------|-------|--------|----------------|
| R-001 | Risk | [Description] | High | [Name] | Open | [Action] |
| B-001 | Blocker | [Description] | Critical | [Name] | Active | [Action by date] |
| I-001 | Issue | [Description] | Medium | [Name] | Investigating | [Action] |

Mit dem Charter-Risikoregister abgleichen. Alle neu identifizierten Risiken markieren.

Erwartet: Alle aktiven Blockaden und Top-Risiken mit Verantwortlichen und Massnahmen dokumentiert.

Bei Fehler: Wenn keine Blockaden vorhanden sind, explizit "Keine aktiven Blockaden" angeben — den Abschnitt nicht leer lassen. Wenn einer Blockade ein Verantwortlicher fehlt, an den Projektmanager zur Zuweisung eskalieren.

Schritt 4: Leistungen und Plan fuer naechsten Zeitraum zusammenfassen

Zwei Abschnitte schreiben:

## Accomplishments (This Period)
- [Completed item/milestone with evidence]
- [Completed item/milestone with evidence]
- [Completed item/milestone with evidence]

## Planned (Next Period)
- [Planned item/milestone with target]
- [Planned item/milestone with target]
- [Planned item/milestone with target]

Erwartet: 3-5 Leistungen mit konkreten Belegen, 3-5 geplante Eintraege fuer den naechsten Zeitraum.

Bei Fehler: Wenn keine Leistungen vorhanden sind, den Grund berichten (blockiert, Neuplanung, Team nicht verfuegbar). Wenn der Plan fuer den naechsten Zeitraum unklar ist, "Planungssitzung geplant fuer [Datum]" als Haupteintrag auffuehren.

Schritt 5: RAG-Indikatoren zuweisen und Bericht schreiben

Projektgesundheit in vier Dimensionen bewerten:

DimensionGruenGelbRot
ZeitplanIm Plan oder voraus1-2 Wochen zurueck>2 Wochen zurueck oder Meilenstein verpasst
UmfangKeine unkontrollierten AenderungenGeringfuegige UmfangsanpassungenScope Creep beeintraechtigt Lieferergebnisse
BudgetInnerhalb 5% des Plans5-15% ueber Plan>15% ueber Plan oder nicht nachverfolgt
QualitaetTests bestehen, Kriterien erfuelltGeringfuegige QualitaetsproblemeKritische Maengel oder Abnahmefehler

Den vollstaendigen Bericht schreiben:

# Status Report: [Project Name]
## Report Date: [YYYY-MM-DD]
## Reporting Period: [Start] to [End]
## Document ID: SR-[PROJECT]-[YYYY-MM-DD]

### Overall Health
| Dimension | Status | Notes |
|-----------|--------|-------|
| Schedule | 🟢/🟡/🔴 | [One-line explanation] |
| Scope | 🟢/🟡/🔴 | [One-line explanation] |
| Budget | 🟢/🟡/🔴 | [One-line explanation] |
| Quality | 🟢/🟡/🔴 | [One-line explanation] |

### Executive Summary
[2-3 sentences: overall status, key achievement, biggest risk]

### Metrics
[From Step 2]

### Accomplishments
[From Step 4]

### Blockers & Risks
[From Step 3]

### Planned Next Period
[From Step 4]

### Decisions Needed
- [Decision 1 — needed by date, from whom]

---
*Report prepared by: [Name/Agent]*

Als STATUS-REPORT-[YYYY-MM-DD].md speichern.

Erwartet: Vollstaendiger Statusbericht gespeichert mit RAG-Indikatoren, Kennzahlen und Narrativ.

Bei Fehler: Wenn Daten fuer die RAG-Bewertung ungenuegend sind, ⚪ (Grau) verwenden mit dem Hinweis "ungenuegend Daten" und auflisten, welche Daten fuer den naechsten Bericht gesammelt werden muessen.

Validierung

  • Statusberichtsdatei mit korrektem datumsgestempeltem Dateinamen erstellt
  • RAG-Indikatoren fuer alle vier Dimensionen mit Begruendung zugewiesen
  • Mindestens 3 Kennzahlen aus Projektartefakten berechnet
  • Blockaden-Abschnitt vorhanden (auch wenn "Keine aktiven Blockaden")
  • Leistungen mit Belegen aufgelistet
  • Plan fuer naechsten Zeitraum enthalten
  • Executive Summary ist 2-3 Saetze, kein Absatz
  • Jede Blockade und jedes Risiko hat einen Verantwortlichen und eine Massnahme mit Frist

Haeufige Stolperfallen

  • Bericht ohne Daten: Statusberichte muessen evidenzbasiert sein. Jede Aussage sollte ein Artefakt oder eine Kennzahl referenzieren.
  • Alles immer Gruen: Dauerhaftes Gruen ohne Belege deutet darauf hin, dass der Bericht nicht ehrlich ist. Gruen-Bewertungen hinterfragen.
  • Blockade ohne Verantwortlichen: Jede Blockade braucht einen Verantwortlichen und eine Massnahme. Unbesitzte Blockaden werden nicht geloest.
  • Kennzahl ohne Kontext: "Velocity = 18" bedeutet nichts ohne Vergleich. Immer den Vorjahreszeitraum oder das Ziel einbeziehen.
  • Zu lang: Ein Statusbericht sollte in 2 Minuten ueberschaubar sein. Auf 1-2 Seiten beschraenken.
  • Fehlender Entscheidungsabschnitt: Wenn das Projekt Stakeholder-Entscheidungen benoetigt, diese mit Fristen explizit machen.
  • Veraltete Daten: Veraltete Artefakte fuehren zu irrefuehrenden Berichten. Artefaktdaten auf den Berichtszeitraum abgleichen.
  • Fehlende Trenddaten: Erstberichte koennen keine Trends zeigen, aber nachfolgende Berichte muessen mit vorherigen Zeitraeumen vergleichen.

Verwandte Skills

  • draft-project-charter — Charter liefert Meilensteine und Erfolgskriterien fuer das Status-Tracking
  • manage-backlog — Backlog-Kennzahlen speisen den Statusbericht
  • plan-sprint — Sprint-Ergebnisse liefern Velocity- und Abschlussdaten
  • create-work-breakdown-structure — PSP-Abschluss treibt klassische Fortschrittskennzahlen
  • conduct-retrospective — Statusberichtsdaten speisen die Retrospektive

GitHub Repository

pjt222/agent-almanac
Path: i18n/de/skills/generate-status-report
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill