| name | release-download-stats |
| description | Check and summarize PwrAgent GitHub Release asset download statistics. Use when the user asks for download counts, bytes served, DMG or ZIP stats, updater ZIP traffic, per-release stats such as beta.22/beta.21/beta.20, or whether GitHub release downloads show any traffic. |
Release Download Stats
Use this skill to inspect GitHub Release asset metadata for
pwrdrvr/PwrAgent. It reports cumulative GitHub download_count values for
release assets; it does not identify users and it does not count update-check
polls.
Workflow
-
Run the bundled script from the repo root:
python3 .agents/skills/release-download-stats/scripts/release_download_stats.py
-
For specific releases, pass exact tags or PwrAgent shorthand:
python3 .agents/skills/release-download-stats/scripts/release_download_stats.py beta.22 beta.21 beta.20
-
For the latest N releases:
python3 .agents/skills/release-download-stats/scripts/release_download_stats.py --latest 5
-
Summarize the results in the response. Prefer:
- ZIP updater downloads separately from DMG downloads.
PwrAgent.dmg stable alias separately from versioned DMG assets.- Total DMG as
stable alias + versioned DMG only when useful.
- GiB totals for approximate transfer volume.
Interpretation Rules
- Treat GitHub values as cumulative per asset, not per day.
- State that GitHub does not distinguish manual downloads, bots, CI, or
auto-updater downloads.
- State that update-check polls against
latest-mac.yml are not represented by
these asset counts.
- When both
PwrAgent.dmg and a versioned .dmg are present, do not collapse
them unless the user asks for total DMG traffic.
- Use UTC timestamps unless the user asks for a local timezone conversion.
Common Commands
Print markdown tables:
python3 .agents/skills/release-download-stats/scripts/release_download_stats.py beta.22 beta.21 beta.20
Emit JSON for further processing:
python3 .agents/skills/release-download-stats/scripts/release_download_stats.py --json --latest 10
