weekly-summary

name	weekly-summary
description	Generate a concise weekly progress summary for the pharma_skills repository. Use this to summarize recent commits, PRs, and issues, then post the update to Slack and save it as a markdown file.

Weekly Summary Skill

This skill automates the generation of a developer-focused weekly summary for the RConsortium/pharma_skills repository.

Configuration

Before running, read _automation/weekly-summary/config.json to load:

• max_words — word limit for the summary (default 150)
• slack_channel — Slack channel ID to post to (overridden by PHARMA_SKILLS_SLACK_CHANNEL env var)
• lookback_days — how many days of activity to include (default 7)

If PHARMA_SKILLS_SLACK_CHANNEL is set in the environment, it takes precedence over config.json. If neither is set, stop and report an error — do not guess a channel ID.

Steps

1. Research Recent Activity

   • Run the following command to retrieve structured data for the configured lookback period:

     python3 _automation/weekly-summary/scripts/get_weekly_data.py
     

   • Use the JSON output to identify the number of commits, open/closed issues, and merged/open PRs.

2. Generate Summary

   • Write a developer-focused summary under max_words words (from config) in Slack mrkdwn format.
   • Use the following structure: 📊 pharma_skills — week of [DATE] • Commits: [count + one-line highlight] • PRs: [merged/open count + key change or discussion] • Issues: [opened/closed count + notable item] • TL;DR: [1-2 sentences on overall momentum and what to watch next week]
   • Skip any section with no activity.
   • Be direct and terse.

3. Slack Output

   • Read the Slack channel from the environment variable PHARMA_SKILLS_SLACK_CHANNEL, falling back to slack_channel in config.json.
   • Post the summary to Slack using an available webhook or chat integration tool.

4. File Output

   • Save the summary as a markdown file: /sessions/[session-dir]/mnt/outputs/pharma-skills-weekly-summary-[YYYY-MM-DD].md.
   • Present or output the path to the saved file so the user can review it.