midnite-git-report

Generates git activity and phase-progress reports with merged PR tables and PDF export.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/bilo-io/midnite-studio --skill midnite-git-report-bilo-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: midnite-git-report
Source: https://github.com/bilo-io/midnite-studio/tree/main/.agents/skills/midnite-git-report
Command: npx skills add https://github.com/bilo-io/midnite-studio --skill midnite-git-report-bilo-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Compiling a daily or weekly summary of repository activity — merged pull requests, lines changed, and project phase progress — requires manually querying GitHub, parsing git logs, and reading task trackers, which is repetitive and error-prone. ## Core Features & Use Cases - Windowed activity reports: Resolves flexible time windows (today, yesterday, this week, this month, or explicit date ranges) and reports merged PRs with SAST-corrected merge times, line deltas, and status mix. - Phase progress tracking: Aggregates PRs per project phase and reads overall completion from a pre-computed task index, rendered as tables with unicode progress bars. - PDF export: Renders the same report through a bundled data-driven HTML template via headless Chrome for end-of-day archival. - Use Case: At the end of a workday, ask for yesterday's report to get a linked table of merged PRs, per-phase line changes, and overall phase completion, plus a polished PDF saved to the Desktop. ## Quick Start Ask the assistant to run the git report for this week and include the PDF export.

Frequently Asked Questions about midnite-git-report

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

FAQPage Schema
How do I generate a git activity report for a date range?▼

Invoke the skill with a period argument such as today, yesterday, this-week, this-month, a single YYYY-MM-DD date, or a START..END range. If no period is given, it asks one question offering Today, Yesterday, This week, or This month before resolving concrete dates.

How to list merged GitHub PRs within a specific time window?▼

The skill runs gh pr list --state merged with a merged: search query bounded by ISO timestamps carrying a +02:00 offset, returning number, title, url, mergedAt, additions, deletions, and author with --limit 200. If gh is unavailable it falls back to git log merge commits.

Why do GitHub PR merge times show the wrong timezone?▼

The gh CLI returns mergedAt in UTC, so bare times read two hours early in SAST. The skill converts timestamps with jq by adding 7200 seconds, since SAST has no daylight saving, rather than displaying the raw UTC string.

Can the git report be exported as a PDF?▼

Yes, for complete-day windows or on demand the skill fills a bundled HTML template's DATA object and prints it with headless Chrome using --print-to-pdf. If no Chrome or Chromium binary exists, it skips the PDF without failing the report.

What data sources does the phase progress report use?▼

Phase progress comes only from the pre-computed .midnite/tasks/_INDEX.md roll-up, never from individual phase files. Shipped items are counted via a date-filtered grep of done.md, and PR-to-phase mapping uses PR titles plus git log --name-only.