newsletter-cache-refresh

Generate monthly activity cache files for three SCRC repositories.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/PLeVasseur/opencode-project-agents --skill newsletter-cache-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: newsletter-cache-refresh
Source: https://github.com/PLeVasseur/opencode-project-agents/tree/main/scrc-newsletter/skills/newsletter-cache-refresh
Command: npx skills add https://github.com/PLeVasseur/opencode-project-agents --skill newsletter-cache-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refresh SCRC activity data caches into .cache/YYYY-MM/ to enable consistent analytics and reporting across the three SCRC repositories.

Core Features & Use Cases

  • Automates fetching of activity data for a specified month and stores results under the appropriate cache path.
  • Generates a summary.json and per-repo data files (commits.json, prs.json, issues.json, releases.json) to support downstream reporting and reconciliation.
  • Supports optional date ranges and configurable output directory to fit different workflows.

Quick Start

Run the cache tool for a specific month using uv run python tools/newsletter/fetch_activity.py --month YYYY-MM.

Frequently Asked Questions about newsletter-cache-refresh

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

FAQPage Schema
How do I automate fetching GitHub repository activity data for monthly newsletter reporting?

Automating GitHub repository activity data collection involves running a Python script to fetch commits, PRs, issues, and releases, storing them as JSON files under a dated cache directory like .cache/YYYY-MM. This automatically generates a summary.json and per-repo data files to support consistent downstream reporting.

What is included in the SCRC activity data cache for monthly views?

The SCRC activity data cache includes a summary.json file and individual per-repo JSON files containing commits, PRs, issues, and releases data. These files are organized under a .cache/YYYY-MM/ directory structure to support analytics and reconciliation across three specific repositories.

Can I generate cache data for a custom date range instead of just a single month?

Yes, you can generate cache data for a custom date range by passing optional start and end dates to the fetch activity script. You can also configure a custom output directory to fit your specific workflow and reporting needs.

Do I need the uv runtime to run the Python fetch_activity script?

Yes, the uv runtime is required to execute the fetch_activity script. You run the cache refresh tool using the command format uv run python tools/newsletter/fetch_activity.py --month YYYY-MM to populate the necessary cache directories.

Why does my monthly activity data cache need to be refreshed automatically?

Refreshing the activity data cache automatically ensures consistent analytics and reporting across multiple repositories. It fetches the latest commits, PRs, issues, and releases, storing them in structured JSON files to prevent data misalignment in downstream newsletter generation.