product-activity-report

Generate plain-language product activity reports from GitHub pull requests and issues.

78|27|Updated May 4, 2024
One-click install
npx skills add https://github.com/fedixyz/fedi --skill product-activity-report-fedixyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-activity-report
Source: https://github.com/fedixyz/fedi/tree/main/.agents/skills/product-activity-report
Command: npx skills add https://github.com/fedixyz/fedi --skill product-activity-report-fedixyz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Non-technical stakeholders cannot tell what a team is actually shipping from raw GitHub activity, because most pull requests and issues are internal engineering work. This Skill triages merged PRs, open PRs, and issues into a short, jargon-free report of what changed for users, what is in progress, and what is planned. ## Core Features & Use Cases - User-impact triage: Filters out tests, CI, refactors, and developer tooling, keeping only changes a person would notice in the product. - Verified release status: Uses the bundled shipped_status.py script to check whether merged work is contained in the actually deployed native and web builds, including cherry-picked releases and feature-flag gates, before calling anything Shipped. - Dual output rendering: Produces a self-contained HTML report and a matching inline markdown briefing from one JSON file via render_report.py, so both outputs never disagree. - Use Case: A founder asks "what did the team ship this month?" The Skill pulls recent GitHub activity, verifies liveness per platform, and returns a ranked ten-item briefing with links to the underlying work. ## Quick Start Ask the assistant to summarize what the team has shipped and is currently building in this repository as a plain-language product update.

Frequently Asked Questions about product-activity-report

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

FAQPage Schema
How do I turn GitHub pull requests into a product update for non-technical stakeholders?

Pull recent merged PRs, open PRs, and active issues with the GitHub CLI, filter out internal engineering work like tests and CI, then cluster the rest into at most ten user-facing items. The Skill renders both an HTML report and an inline briefing from one JSON file.

How do I check if a merged pull request is actually released to users?

Run the bundled shipped_status.py script with the PR numbers against a local clone. It resolves the actually deployed ref per platform from deploy workflow runs and release build records, then checks containment by ancestry, PR number, and title.

Why does a merged pull request not count as shipped?

Merging to master is not releasing: release lineages are cut from previous tags plus cherry-picks, and web production deploys are manual. A change also needs its production feature flag on and its own code present in the deployed build, not just the flag flip.

Can this report cover multiple repositories or a product that has not launched?

Yes. Multiple repos produce one merged, repo-tagged ranking. For pre-product repos with no releases, the report shifts to describing capabilities being built, declares the unlaunched state in the intro, and never uses the Shipped status.

What are the limitations of title-based containment checks?

A title match in a squashed backport only counts when exactly one pull request owns that title, since a change and its revert often share one. Ambiguous matches are reported as maybe and must not be claimed as live.