File contents 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_TOKENGITHUB_REPOS (comma/space/newline separated)GITHUB_USERNAME (preferred) or GITHUB_AUTHOR (backward compatible)
Required env (Jira)
JIRA_BASE_URLJIRA_USERNAMEJIRA_API_TOKENJIRA_PROJECT_KEYS
Optional Jira env:
JIRA_ASSIGNEE (defaults to JIRA_USERNAME)JIRA_EMAIL, JIRA_FULL_NAME (improves “my comments” detection)JIRA_AUTH_METHOD = bearer/basicJIRA_VERIFY_SSL = true/falseJIRA_CA_BUNDLE = path to CA bundle
Output env
REPORT_OUT_DIR (default: current dir)
Outputs
weekly_report.mdweekly_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>
1 --- 2 name: weekly-report 3 description: Weekly Report Skill 4 --- 5 6 # Weekly Report Skill 7 8 ## When to use 9 - Use this every Friday to generate a weekly report from Jira and GitHub. 10 11 ## Date range 12 - Defaults to last 7 days (inclusive), ending today. 13 - Override: 14 - `--since YYYY-MM-DD --until YYYY-MM-DD` 15 16 ## .env support 17 - If `.cursor/skills/weekly-report/.env` exists, it is loaded automatically. 18 19 ## Required env (GitHub) 20 - `GITHUB_TOKEN` 21 - `GITHUB_REPOS` (comma/space/newline separated) 22 - `GITHUB_USERNAME` (preferred) or `GITHUB_AUTHOR` (backward compatible) 23 24 ## Required env (Jira) 25 - `JIRA_BASE_URL` 26 - `JIRA_USERNAME` 27 - `JIRA_API_TOKEN` 28 - `JIRA_PROJECT_KEYS` 29 30 Optional Jira env: 31 - `JIRA_ASSIGNEE` (defaults to `JIRA_USERNAME`) 32 - `JIRA_EMAIL`, `JIRA_FULL_NAME` (improves “my comments” detection) 33 - `JIRA_AUTH_METHOD` = bearer/basic 34 - `JIRA_VERIFY_SSL` = true/false 35 - `JIRA_CA_BUNDLE` = path to CA bundle 36 37 ## Output env 38 - `REPORT_OUT_DIR` (default: current dir) 39 40 ## Outputs 41 - `weekly_report.md` 42 - `weekly_report.json` 43 44 ## GitHub logic 45 - **Merged (authored by me)**: `author:<me> is:pr is:merged merged:<range>` 46 - **Reviews I did**: `reviewed-by:<me>` and/or `commenter:<me> commented:<range>`, excluding `author:<me>` 47 - **WIP**: `author:<me> is:pr is:open updated:<range>`
commit 0e7cfeeb46
Frequently asked questions How do I install the Weekly Report skill? Run npx skillmds@latest add alirana01/weekly-report in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Weekly Report skill do? Weekly Report Skill It is listed under Docs & Writing on SkillMD.
Is Weekly Report safe to use? This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Weekly Report? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Weekly Report free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Weekly Report? alirana01 (@alirana01) published this skill. Their other Agent Skills are listed on their SkillMD profile.
alirana01