Skip to content
Skills Library
Data & analytics · Writing

github-report-builder

/github-report-builder

Build structured JSON reports from GitHub repository activity data. Use this skill whenever you need to compile PR and issue statistics into a formatted JSON file for meeting summaries, community pulse reports, or stakeholder updates. Triggers on tasks that require outputting a report.json or similar artifact from GitHub metrics.

Licence
MIT
Last repository change
02.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Build structured JSON reports from GitHub repository activity data. Use this skill whenever you need to compile PR and issue statistics into a formatted JSON file for meeting summaries, community pulse reports, or stakeholder updates. Triggers on tasks that require outputting a report.json or similar artifact from GitHub metrics.

Original author description

Build structured JSON reports from GitHub repository activity data. Use this skill whenever you need to compile PR and issue statistics into a formatted JSON file for meeting summaries, community pulse reports, or stakeholder updates. Triggers on tasks that require outputting a report.json or similar artifact from GitHub metrics.

How it works

  1. Report Schema
  2. Computation Notes
  3. Output
Original SKILL.md headings · 47 lines, 215 words
SKILL.md preview
---
name: github-report-builder
description: >
  Build structured JSON reports from GitHub repository activity data. Use this skill
  whenever you need to compile PR and issue statistics into a formatted JSON file for
  meeting summaries, community pulse reports, or stakeholder updates. Triggers on tasks
  that require outputting a report.json or similar artifact from GitHub metrics.
---

# GitHub Report Builder

Compile GitHub activity metrics into a structured JSON report.

## Report Schema

```json
{
  "pr": {
    "total": "<int> total PRs created in period",
    "merged": "<int> PRs merged (as of query time)",
    "closed": "<int> PRs closed without merge (as of query time)",
    "avg_merge_days": "<float> average days from creation to merge, 1 decimal",
    "top_contributor": "<str> login of user who opened the most PRs"
  },
  "issue": {
    "total": "<int> total issues created in period",
    "bug": "<int> issues with a label containing 'bug'",
    "resolved_bugs": "<int> bug issues that were closed during the period"
  }
}
```

## Computation Notes

### avg_merge_days

1. Filter to merged PRs only.
2. For each: `(mergedAt - createdAt)` in fractional days.
3. Average all values, round to 1 decimal place.
4. If no PRs were merged, use `0.0`.

### top_contributor

- Count PRs per `author.login`.
- If there is a tie, pick the one that appears first alphabetically (or as the requester specifies).

### resolved_bugs (closed during the month)

- Filter issues to those with at least one label containing `bug`.
- Among those, count the ones whose `closedAt` timestamp falls within the report period.

## Output

Write the JSON to the specified path using `Write` tool or `jq`. Ensure numeric types are correct (integers for counts, float for avg_merge_days).

Versions

The database has no other skills named github-report-builder.

Database snapshot: 13.11.2026 · package version a93056b1adae (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100github-metrics-aggregation
    Aggregate GitHub PR and issue data into structured metrics, including contributor analysis, merge statistics, and bug categorization. Use this skill when compiling activity reports, computing open-source velocity metrics, or generating community pulse summaries.
  • 95github-repo-stats
    How to gather GitHub repository statistics (PRs, issues, contributors) using the GitHub REST API via curl and Python. Use this skill whenever the user asks for a community pulse, activity summary, monthly report, or repository metrics for any GitHub repo — even if they don't…
  • 100evo-gh-report-generator
    Computes community pulse metrics from raw PR and issue data and writes a structured report.json file. Calculates PR counts by state, average time-to-merge, top contributor, bug issue counts, and resolved bugs. Use when you need to generate GitHub repository health metrics reports.
  • 100github-repository-data-collector
    When the user needs to collect specific repository information from GitHub for analysis, reporting, or archival purposes. This skill fetches repository data from the GitHub API using repository IDs, extracts key metrics (name, owner, stars, forks, creation time, description,…
  • 98data-analysis
    Loads CSV, Excel, and JSON data files, performs statistical analysis, and generates charts and reports. Use when the user asks to analyze a dataset, compute statistics, create visualizations, find trends, or produce a data report.
  • 100pulse-repo-stats
    Build the Pulse engineering dashboard for a GitHub repo on this computer, as one HTML file - release weeks, PRs merged per week, review wait, time to merge, unreviewed merges, the commit grid, who does the work, how much of it AI agents do, and branch rules. Use when someone…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.