ar-weekly-report

Generate evidence-grounded weekly status reports from task tracking artifacts and GitHub PR state.

1|2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-weekly-report-mahsanamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ar-weekly-report
Source: https://github.com/mahsanamin/agentic-repos/tree/main/workspace-skills/ar-weekly-report
Command: npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-weekly-report-mahsanamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing weekly status reports by hand means digging through task folders, PRs, meeting notes, and project state files, then translating engineering detail into audience-appropriate prose without fabricating or overstating progress. This Skill automates that evidence gathering and enforces a strict no-fabrication, no-engineering-jargon writing process. ## Core Features & Use Cases - Evidence-first reporting: Builds a Phase A evidence table from TasksSummary files, per-task folders, meeting summaries, ProjectState, and live gh pr queries before writing any prose. - Audience-configurable voice: Reads config_hints.json to match tone and detail level for executives, engineering leads, or product teams, stripping branch names, ticket numbers, and PR chatter from management copy. - Defensible classification: Applies a fixed decision matrix (Shipped, Development Done, In progress, Concerns, Next) based on merge target, deploy confirmation, and mock/stub state, with a multi-step self-review before saving. - Use Case: On a Friday, ask for the weekly report and receive a saved Markdown report where every claim traces to a this-week source, carried-forward items are accounted for, and mocked dependencies are explicitly disclosed. ## Quick Start Say "ar-weekly-report" or "weekly report" to generate this week's evidence-grounded status report for the configured audience.

Frequently Asked Questions about ar-weekly-report

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

FAQPage Schema
How do I generate a weekly status report from task tracking files?▼

Run the weekly report skill after ensuring skill.config and TasksSummary files exist. It reads task folders, meeting summaries, ProjectState, and GitHub PRs, builds an evidence table, classifies each item, and saves a dated Markdown report to the configured reports folder.

How to write a weekly report for executives without engineering jargon?▼

Configure the audience in config_hints.json under weekly_report.audience, for example "CEO and CTO". The skill then strips ticket numbers, branch names, PR references, and endpoint paths, translating implementation detail into user and business outcomes.

Does the weekly report verify whether work actually shipped to production?▼

Yes. It queries each referenced PR with the gh CLI and checks baseRefName and mergedAt. Work merged to any branch other than main is classified as In progress, and deploy status must be confirmed by a this-week source before anything counts as Shipped.

What happens if a required source file is missing?▼

The skill names the exact missing file, such as skill.config or the configured project_state_path, and stops rather than inventing content. Missing weekly summary files for completed tasks are recreated from the task folder's execution summary.

How are mocked or stubbed dependencies reported in status updates?▼

Mock state is treated as a milestone modifier, not hidden. The skill greps task folders for terms like mock, stub, placeholder, and feature flag, and any milestone claiming completion must explicitly state which calls are real, which are mocked, and the follow-up that switches them.