# Weekly Report

> Weekly Report Skill

- Skill: `alirana01/weekly-report` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add alirana01/weekly-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alirana01/weekly-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: alirana01 (https://skillmd.com/u/alirana01)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/alirana01/weekly-report

---


# Weekly Report Skill

## When to use
- Use this every Friday to generate a weekly report from Jira and GitHub.

## Date range
- Defaults to last 7 days (inclusive), ending today.
- Override:
  - `--since YYYY-MM-DD --until YYYY-MM-DD`

## .env support
- If `.cursor/skills/weekly-report/.env` exists, it is loaded automatically.

## Required env (GitHub)
- `GITHUB_TOKEN`
- `GITHUB_REPOS` (comma/space/newline separated)
- `GITHUB_USERNAME` (preferred) or `GITHUB_AUTHOR` (backward compatible)

## Required env (Jira)
- `JIRA_BASE_URL`
- `JIRA_USERNAME`
- `JIRA_API_TOKEN`
- `JIRA_PROJECT_KEYS`

Optional Jira env:
- `JIRA_ASSIGNEE` (defaults to `JIRA_USERNAME`)
- `JIRA_EMAIL`, `JIRA_FULL_NAME` (improves “my comments” detection)
- `JIRA_AUTH_METHOD` = bearer/basic
- `JIRA_VERIFY_SSL` = true/false
- `JIRA_CA_BUNDLE` = path to CA bundle

## Output env
- `REPORT_OUT_DIR` (default: current dir)

## Outputs
- `weekly_report.md`
- `weekly_report.json`

## GitHub logic
- **Merged (authored by me)**: `author:<me> is:pr is:merged merged:<range>`
- **Reviews I did**: `reviewed-by:<me>` and/or `commenter:<me> commented:<range>`, excluding `author:<me>`
- **WIP**: `author:<me> is:pr is:open updated:<range>`