Agent skill

My Weekly Report

by meain in meain/dotfiles

Generate a concise weekly status update in team format. An agent skill from meain/dotfiles.

MITAuto-check passedWriting & Content

Install My Weekly Report

skills CLI
$ npx skills add meain/dotfiles --skill my-weekly-report -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install meain/dotfiles my-weekly-report --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/.agents/skills/my-weekly-report .claude/skills/my-weekly-report && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
my-weekly-report
GitHub stars
285
Token cost
~2.5k tokens
SKILL.md length
1,195 words
Files
6 (incl. scripts)
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Generate a concise weekly status update in team format. An agent skill from meain/dotfiles.

  • Works in 9 steps: Compute the reporting window → Get the exact date range as YYYY-MM-DD → Check GitHub PRs (authored + reviewed) → …
  • Tasks that involve Internal communications
  • SKILL.md covers Format, Critical: sandbox, Steps and Known gh/jira/confluence…, plus 1 more section
  • Runs Shell scripts from its folder; calls gh and jq

What it does

My Weekly Report is an agent skill from meain/dotfiles. Generate a concise weekly status update in team format. "What I worked on" is built from the most recently completed Monday-Sunday week in the personal backlog archive (Backlog/Backlog.md, " Before" section), cross-referenced with Jira, GitHub PRs (authored + reviewed), and Confluence edits from that same window. "What's next" comes strictly from the current Jira sprint's To Do tickets. Ends by opening the team's Confluence status page for that week and handing back its plain link. Triggers: /my-weekly-report…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `scripts/confluence-doc-link.sh`, `scripts/confluence-updates.sh` and `scripts/last-week-backlog.sh`).

It sits in Writing & Content, covering Internal communications. It works with Confluence, Jira and GitHub. The repository describes itself as: If there is a shell, there is a way! The licence is MIT.

When your agent uses it

  • Tasks that involve Internal communications

Example prompts

  • “What I worked on”
  • “Before”
  • “s next”
  • “/my-weekly-report”

Requirements

  • A Bash shell

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Compute the reporting window
  2. Get the exact date range as YYYY-MM-DD
  3. Check GitHub PRs (authored + reviewed)
  4. Check Confluence for docs touched in the window
  5. Get current sprint's To Do tickets
  6. Build the report
  7. Copy to clipboard
  8. Find and open the team's Confluence status page
  9. Show the final draft

What it can do on your machine

Read from SKILL.md and the folder at commit 3e336e2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

My Weekly Report loads about 2.5k tokens when it runs. Until then it costs about 159 tokens; SKILL.md has 1,195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~159
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from meain/dotfiles at commit 3e336e2, republished under its MIT licence (© meain). 1,195 words, ~2,517 tokens.

Download SKILL.mdSave it as .claude/skills/my-weekly-report/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
my-weekly-report
description
Generate a concise weekly status update in team format. "What I worked on" is built from the most recently completed Monday-Sunday week in the personal backlog archive (Backlog/Backlog.md, "## Before" section), cross-referenced with Jira, GitHub PRs (authored + reviewed), and Confluence edits from that same window. "What's next" comes strictly from the current Jira sprint's To Do tickets. Ends by opening the team's Confluence status page for that week and handing back its plain link. Triggers: /my-weekly-report, "my weekly update", "my weekly status", "generate my weekly", "write my weekly", "my weekly report"
user_invocable
true

/my-weekly-report — Weekly Status Update Generator

Generate a concise weekly update in the team's standard format.

Format

## Abin Simon

**What I worked on:**
- <bullet per notable thing done in the reporting week>

**What's next:**
- <bullet for each To Do ticket in the current sprint>

**Blockers:** None
**Upcoming leaves:** None
**Unplanned leaves last week:** None

Always output the report directly in the chat — do NOT write it to a file.

Critical: sandbox

Every command below hits a network API (Jira, GitHub, Confluence) and will fail with a TLS/certificate error under the default sandbox. Run every Bash call in this skill with dangerouslyDisableSandbox: true. This is the single most common failure mode when running this skill — if a command fails with tls: failed to verify certificate or similar, that's the sandbox, not a real problem.

Steps

1. Compute the reporting window

"What I worked on" covers the most recently completed Monday-Sunday week — not "since Monday of this week." Reports are typically generated a day or more into the new week, so the prior full week is what has actual completed work to report; the current week in progress rarely does.

bash
~/.agents/skills/my-weekly-report/scripts/last-week-backlog.sh

With no argument this returns last week (Mon-Sun). Pass 0 instead to get the current week-to-date if the user explicitly asks for that.

The output labels every day with its weekday name and date, including Saturday/Sunday (shown as "(no entries)" if empty) — this lets you see the full week shape and decide whether weekend work is worth including.

Do not filter items out on the assumption they're personal. If it's ambiguous whether something is personal or work (e.g. "Apply for leave", "Schedule 1-on-1s"), leave it in your working notes and let the final "What I worked on" draft skip only the obviously-personal ones (banking, health, shopping). When genuinely unsure, include it — the user filters the final draft, not you.

Note on refiling — normally not something you need to think about. The target week should already be in Backlog.md's ## Before section, since that's the week just completed. This only becomes relevant if last-week-backlog.sh comes back empty for every single day (e.g. a manual re-run for an older week): the vault periodically refiles old ## Before entries out of Backlog.md into Backlog/Refiled/YYYY/MM/Backlog.md. Those refiled files drop the ## Before header — they're just bare ### YYYY-MM-DD (Day) sections at the top of the file. If you hit an all-empty week, check the matching Refiled/YYYY/MM/Backlog.md directly instead of assuming it was a light week.

2. Get the exact date range as YYYY-MM-DD

You'll need this for steps 3 and 4. Compute it the same way the script does:

bash
dow=$(date +%u)
this_monday=$(date -d "-$((dow - 1)) days" "+%Y-%m-%d")
start=$(date -d "$this_monday -7 days" "+%Y-%m-%d")   # last Monday
end=$(date -d "$this_monday -1 days" "+%Y-%m-%d")     # last Sunday
3. Check GitHub PRs (authored + reviewed)
bash
~/.agents/skills/my-weekly-report/scripts/pr-activity.sh "$start" "$end" $(cat ~/.config/datafiles/prs-repos)

Returns { "authored": [...], "reviewed": [...] } for that date range.

  • authored: PRs you opened or that got merged in the window — evidence of completed work, use to enrich or add bullets.
  • reviewed: PRs where you left a review or comment in the window (checked per-PR, not just by the PR's own updatedAt — a stale-looking PR can still have a fresh review from you). Roll these into a single "PR reviews" bullet with short refs (e.g. cpb#5152, cpb#5372) rather than listing each as its own bullet.

If this returns mostly empty, don't pad the report — a light week is a light week. But cross-check step 1's output first: PR review activity in particular is easy to under-report from GitHub data alone if the backlog already names who/what was reviewed.

4. Check Confluence for docs touched in the window
bash
~/.agents/skills/my-weekly-report/scripts/confluence-updates.sh "$start" "$end"

If any design docs, runbooks, or notable pages were created or edited, add a bullet (e.g. "Continued Org Anchoring design — updated Tech Spec doc").

5. Get current sprint's To Do tickets
bash
jira sprint list --plain --state active --table --no-headers --columns id,name

(Or just run sprint-tickets.sh, below — it does this lookup internally.)

bash
~/.agents/skills/my-weekly-report/scripts/sprint-tickets.sh

Returns JSON grouped by status: done, in_progress, to_do. Only the to_do list feeds "What's next." Do not pull "What's next" from the backlog's Tomorrow/This Cycle/Next Cycle sections — those are personal planning, not the sprint board, and mixing them in was a mistake corrected in a past run of this skill. If done/in_progress are non-empty, they can supplement "What I worked on," but the backlog archive (step 1) is usually the richer source for that.

6. Build the report

What I worked on:

  • Synthesize step 1 (backlog), step 3 (PRs), and step 4 (Confluence) into concise, deduplicated bullets — don't list the same underlying piece of work twice just because it showed up in two sources.
  • Group related items (e.g. all Org Anchoring work in one bullet, all PR reviews in one bullet) rather than one bullet per raw backlog line.
  • Include a Jira link where a ticket ID is known.

What's next:

  • One bullet per to_do sprint ticket (step 5), with Jira link.

Blockers / leaves:

  • Default all three fields to "None" unless the backlog explicitly says otherwise (leave requests, blocker notes).

Keep bullets as short phrases, not full sentences — match the style in /Users/meain/.local/share/sbdb/InfraCloud/Weekly Updates Submitted/.

Show full SKILL.md (428 more words)Show less
7. Copy to clipboard
bash
printf '%s' "<report text>" | pbcopy
8. Find and open the team's Confluence status page
bash
~/.agents/skills/my-weekly-report/scripts/confluence-doc-link.sh

Prints the page title on line 1 and its plain URL on line 2. The page title's date is the Sunday before the current week's Monday, not the Monday itself — e.g. for the week starting Monday 2026-08-10, the page is titled "Updates for week of 2026-08-09." Searching for the Monday's date directly returns nothing; this was a bug in an earlier version of this skill. The script handles this automatically, with a fallback pattern search if the exact page doesn't exist yet.

Open it:

bash
open "<url from the script>"

Requires dangerouslyDisableSandbox: true (it launches a GUI browser).

9. Show the final draft

Print the report block, then the doc link on its own, as a plain URL — not embedded in the report content and not markdown-formatted (no [text](url)), so the user can copy-paste the bare link directly. The report content itself should never contain the doc link.

Do NOT save the report locally — do not write to any file under /Users/meain/.local/share/sbdb/InfraCloud/Weekly Updates Submitted/. The user pastes and saves it manually in Confluence.

Known gh/jira/confluence gotchas (read before debugging a "broken" script)

  • gh search prs --state all is invalid. gh search prs only accepts --state open or --state closed — there is no "all". Omit --state entirely to search every state. (gh pr list --state all is fine — the two commands have different flag validation.) An earlier version of pr-activity.sh's predecessor used --state all here and it silently returned an empty array every time because of a || echo "[]" fallback swallowing the error.
  • gh ... --jq EXPR takes exactly one argument. It does NOT support jq's own --arg flag the way piping into a real jq does. If you need variables in the filter, do gh ... --json X | jq --arg foo "$foo" '...' instead of gh ... --json X --jq --arg foo "$foo" '...' (the latter errors with "accepts at most 1 arg(s)").
  • A PR's updatedAt doesn't prove your activity is recent. Someone else's comment updates it too. To confirm you reviewed something in a specific window, fetch that PR's reviews/comments and check the timestamp of the entry where author.login matches you specifically.
  • jira sprint list (and any jira/gh/confluence call) fails under the sandbox with a TLS certificate error — always disable the sandbox for these, per the note at the top of this file.

Reference Format

See /Users/meain/.local/share/sbdb/InfraCloud/Weekly Updates Submitted/2026/W17.md for the exact style. The Abin Simon section there is the canonical example:

## Abin Simon

**What I worked on:**
- Worked on separating earn query and ingestion service
- Working on pushing JSON schema validation to prod
- Security fixes in multiple repos
- Working with Rushikesh's (Veeam Employee) onboarding
- ADK SKU change and dropping DR for eventhub
- PR reviews
**What's next:**
- Org Anchoring
- Help with onboarding Rushikesh and work on synthetic monitoring

**Blockers:** None
**Upcoming leaves:** None
**Unplanned leaves last week:** April 14, 15

Note: bullets are short phrases, not full sentences. Jira links are optional but preferred for tickets — include them when the ticket ID is known.

© meain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in agents/.agents/skills/my-weekly-report of meain/dotfiles.

  • SKILL.md
  • scripts/confluence-doc-link.sh
  • scripts/confluence-updates.sh
  • scripts/last-week-backlog.sh
  • scripts/pr-activity.sh
  • scripts/sprint-tickets.sh

Open the folder on GitHubat commit 3e336e2

Compare with similar skills

My Weekly Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

My Weekly Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
My Weekly Report this skillmeain/dotfiles285—~2.5kAutomated safety check: PassMIT
Status Update Generatorborghei/Claude-Skills891—~1.9kAutomated safety check: PassMIT
Tool ConnectorZhixiangLuo/10xProductivity479—~925Automated safety check: PassMIT
Akb Ingestdnotitia/akb162—~2kAutomated safety check: PassCustom licence
Enterprise SearchZhixiangLuo/10xProductivity479—~535Automated safety check: PassMIT
Updateakseolabs-seo/AK-Threads-booster275—~1.1kAutomated safety check: NotesMIT

Similar skills

  • Status Update Generator

    borghei/Claude-Skills

    Generate weekly executive status updates from Jira/Linear data exports.

    891 GitHub stars~1.9k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Tool Connector

    ZhixiangLuo/10xProductivity

    Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…

    479 GitHub stars~925 tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Akb Ingest

    dnotitia/akb

    Ingest whatever you point at into an AKB vault — a local file, a web URL, a GitHub PR/release/commit, a Confluence page, or a Jira issue.

    162 GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Enterprise Search

    ZhixiangLuo/10xProductivity

    Search your entire company's institutional knowledge in one query — Slack, Confluence, Jira, Linear, Notion, GitHub, plus any AI or multi-source search tool listed in verifiedconnections.md.

    479 GitHub stars~535 tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed
  • Update

    akseolabs-seo/AK-Threads-booster

    Check AK-Threads-Booster for upstream GitHub updates, safely fast-forward the local skill repo, or install an opt-in weekly Codex automation that keeps the skill on the latest version.

    275 GitHub stars~1.1k tokensUpdated 3 mo ago
    Writing & ContentAuto-check: notes
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from meain/dotfiles

All 35 skills in this repo
  • Recall

    meain/dotfiles

    Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles.

    285 GitHub starsUsed in 1 repo~684 tokens
    Auto-check passed
  • Grill With Docs

    meain/dotfiles

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    285 GitHub starsUsed in 20 repos~875 tokens
    Auto-check passed
  • Backlog

    meain/dotfiles

    Daily backlog management — full planning review OR add a single entry from a URL.

    285 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Concern Review

    meain/dotfiles

    Generate an interactive local HTML review page for a large PR or diff, grouping the changed files by logical concern (not just by file) so a reviewer can go through one theme at a time instead of a…

    285 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Web Search

    meain/dotfiles

    Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles.

    285 GitHub stars~830 tokensUpdated 2 days ago
    Auto-check passed
  • Explain Tests

    meain/dotfiles

    Explain test code changes as a side-by-side HTML page — real test code on the left, a short note on the right saying which case that code covers.

    285 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed

Questions about My Weekly Report

What does My Weekly Report do?

Generate a concise weekly status update in team format. An agent skill from meain/dotfiles. My Weekly Report is an agent skill from meain/dotfiles. Generate a concise weekly status update in team format.

When should I use My Weekly Report?

My Weekly Report fits situations like: tasks that involve Internal communications.

How do I install My Weekly Report in Claude Code?

Run `npx skills add meain/dotfiles --skill my-weekly-report -a claude-code`. Or copy the skill folder (agents/.agents/skills/my-weekly-report in meain/dotfiles) into .claude/skills/my-weekly-report in your project. Claude Code loads it when a task matches its description.

How do I install My Weekly Report in Codex?

Run `npx skills add meain/dotfiles --skill my-weekly-report -a codex`. Or copy the skill folder (agents/.agents/skills/my-weekly-report in meain/dotfiles) into .agents/skills/my-weekly-report in your project. Codex loads it when a task matches its description.

Can I use My Weekly Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add meain/dotfiles --skill my-weekly-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/my-weekly-report, .gemini/skills/my-weekly-report, .github/skills/my-weekly-report and .opencode/skills/my-weekly-report in your project.

What does My Weekly Report need to run?

Going by SKILL.md and its folder, My Weekly Report needs a shell for the scripts in its folder and the command-line tools its instructions call (gh and jq). Our summary lists: A Bash shell.

Does My Weekly Report access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is My Weekly Report safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does My Weekly Report use?

My Weekly Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does My Weekly Report use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to My Weekly Report?

Skills that share tags, products or a category with My Weekly Report: Status Update Generator (borghei/Claude-Skills, 891 stars), Tool Connector (ZhixiangLuo/10xProductivity, 479 stars), Akb Ingest (dnotitia/akb, 162 stars) and Enterprise Search (ZhixiangLuo/10xProductivity, 479 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains My Weekly Report?

meain (a GitHub user) maintains it in meain/dotfiles, which has 285 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 8, 2026.

Source: meain/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.