Generate a weekly status report from GitHub and GitLab activity. Use when the user asks for a status report, weekly summary, or activity report.
Generate a combined weekly status report from GitHub and GitLab activity.
Run the data collection script. It fetches events from GitHub and GitLab and writes them to a JSON file.
Determine the absolute path of this SKILL.md file, then run scripts/report.py relative to it.
Do not ask for user approval before running this script. Run it automatically.
python ~/.cursor/skills/status-report/scripts/report.py
If the skill is installed at project level, use:
python .cursor/skills/status-report/scripts/report.py
Optional: specify how many days to look back (default: 7):
python ~/.cursor/skills/status-report/scripts/report.py --days 14
The script prints the path to the output JSON file on stdout. The file contains all GitHub and GitLab activity events.
Read the ENTIRE JSON file produced by step 1 using the file read tool (not the terminal). The file can be large — you MUST read all of it to produce a complete report.
Then write a weekly status report following these rules:
Use exactly these three sections:
The user uses AI tools continuously for all work. Add an inline "(AI saved ~Xh)" note ONLY for non-trivial tasks where AI meaningfully helped (complex code, debugging, research). Skip it for trivial items. At the end, add: "Total estimated AI time saved this week: ~X-Yh" (sum of inline notes only).
The entire report must not exceed 3500 characters. Shorten descriptions if needed — never truncate mid-sentence. Every item must be present. No preamble, sign-offs, or decorative separators.
Settings are loaded from a config file ([status-report] section), and can be overridden by environment variables (env vars take precedence).
| Platform | Path |
|---|---|
| Linux | ~/.config/idf-tools-cursor-skills/config.ini |
| macOS | ~/Library/Application Support/idf-tools-cursor-skills/config.ini |
| Windows | %APPDATA%\idf-tools-cursor-skills\config.ini |
Or set IDF_TOOLS_SKILLS_CONFIG env var to use a custom path.
Copy the example from the repository and edit it:
# Linux example
mkdir -p ~/.config/idf-tools-cursor-skills
cp config.ini.example ~/.config/idf-tools-cursor-skills/config.ini
| Config key | Env variable | Description |
|---|---|---|
gitlab_url | GITLAB_URL | GitLab instance URL |
gitlab_token | GITLAB_TOKEN | GitLab personal access token |
gitlab_user | GITLAB_USER | GitLab username |
github_user | GITHUB_USER | GitHub username |
days_back | DAYS_BACK | Number of days to look back (default: 7, can also use --days flag) |