generate-progress-report

Generates sprint progress reports from GitHub Projects data in Markdown or Slack format.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill generate-progress-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-progress-report
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/pm/skills/generate-progress-report
Command: npx skills add https://github.com/semicolon-devteam/semo --skill generate-progress-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, gh, jq.

What problem does it solve?

This Skill automates the creation of comprehensive Sprint progress reports, eliminating the manual effort of aggregating task statuses, workloads, and team member contributions from GitHub Projects.

Core Features & Use Cases

  • Iteration Identification: Automatically identifies the current or specified Sprint (Iteration).
  • Task Status Aggregation: Collects and summarizes tasks by status (e.g., completed, in progress, todo) and workload points.
  • Team Member Overview: Provides a breakdown of task progress and completion rates per assignee.
  • Progress Visualization: Generates a clear progress bar and summary tables in markdown or Slack format.
  • Use Case: Before a daily stand-up, you can ask "Sprint 진행 현황 리포트 생성해줘" to get an instant, up-to-date overview of the team's progress and remaining work.

Quick Start

Generate current Sprint report: "Sprint 진행 현황 리포트 생성해줘" Get progress for a specific Sprint: "/SEMO:progress iteration_title:'12월 1/4'"

Frequently Asked Questions about generate-progress-report

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

FAQPage Schema
How do I generate a sprint progress report from GitHub Projects?

Sprint progress reports aggregate task statuses and workload points from GitHub Projects via GraphQL API, summarizing completion rates by status and assignee. This Skill automates the retrieval and formatting into Markdown or Slack output without manual compilation.

Can I get progress reports for the current sprint or a specific iteration?

The Skill identifies the current sprint automatically or accepts a specific iteration title as input. Query the current sprint with a natural request, or specify an iteration title like '12월 1/4' to retrieve progress for that named period.

What information does a sprint progress report include?

Progress reports display task counts by status (completed, in progress, to-do), workload point summaries, per-assignee breakdowns with completion rates, and a visual progress bar. Output formats include Markdown tables and Slack-compatible layouts.

Does this work with GitHub GraphQL API and jq for data filtering?

Yes. The Skill uses the GitHub GraphQL API to query project data and jq to parse and aggregate JSON responses. Bash orchestrates the workflow; you need gh CLI configured for authentication.

When should I use sprint progress reports instead of manual status checks?

Automated progress reports eliminate manual aggregation before stand-ups or status reviews. Use them for real-time iteration snapshots, multi-assignee visibility, and consistent Markdown or Slack reporting without spreadsheet overhead.

What input validation does the Skill perform?

The Skill validates the iteration title parameter and output format selection (Markdown or Slack). Invalid inputs are rejected before GraphQL queries run, preventing malformed API calls and ensuring output consistency.