report

Generate markdown project status reports and post them to GitHub Projects V2.

2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/cdubiel08/ralph-hero --skill report-cdubiel08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report
Source: https://github.com/cdubiel08/ralph-hero/tree/main/plugin/ralph-hero/skills/report
Command: npx skills add https://github.com/cdubiel08/ralph-hero --skill report-cdubiel08

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation and posting of project status reports, providing clear insights into project velocity and health without manual compilation.

Core Features & Use Cases

  • Automated Reporting: Generates markdown reports summarizing project progress, velocity, and health indicators.
  • Status Updates: Posts reports directly to GitHub Projects V2 as status updates.
  • Configurable Window: Allows customization of the reporting period for velocity and highlights.
  • Use Case: Automatically generate a weekly project status report to keep stakeholders informed about progress, potential risks, and recent achievements.

Quick Start

Use the report skill to generate and post a project status update for the last 7 days.

Frequently Asked Questions about report

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

FAQPage Schema
How do I automate project status reports for GitHub Projects V2?

You can automate project status reports by using a tool that queries pipeline dashboards for velocity metrics, composes markdown summaries, and posts them directly to GitHub Projects V2 as status updates.

What is automated project health determination and how does it work?

Automated project health determination evaluates pipeline velocity and progress metrics to auto-determine project status. It analyzes dashboard data within a specified time window to generate a health indicator without manual assessment.

Can I generate a project status report for a custom time window?

Yes, you can generate a project status report for a custom time window. The reporting period is configurable, allowing you to specify exact time frames for velocity calculations and project highlights.

Does this reporting tool support dry-run mode before posting to GitHub?

Yes, the reporting tool supports an optional dry-run mode. This allows you to preview the generated markdown report and auto-determined health status before actually posting the update to GitHub Projects V2.

How do I override the auto-determined health status in a project report?

You can override the auto-determined health status using manual status overrides. This feature allows you to manually set the project health indicator while still leveraging the automated velocity metrics and markdown generation.

What is the best way to keep stakeholders informed about project velocity and risks?

The best way to keep stakeholders informed is to generate weekly project status reports summarizing progress, velocity, and health indicators. Automating this process eliminates manual compilation and ensures consistent stakeholder updates.