Index of every page on this site: llms.txt
All skills
bitwarden avatar

/weekly-recap

@a11c77b official
by bitwardenbitwarden/ai-plugins165 stars
27
Run it yourself

Generates an interactive HTML recap of the user's own engineering work over one Monday-to-Friday workweek, ready for a weekly standup, 1:1 prep, or sharing with colleagues. Use when the user asks what they worked on, shipped, merged, reviewed, or moved tickets and docs on over a week ("this week", "last week", "the week of" a date), or asks for a "weekly recap", "weekly standup", "weekly summary", "week in review", or "weekly update", including phrasings like "throw together what I did last week". Not for a single day or part of a day, for a multi-day range that is not a Monday-to-Friday week or for several weeks at once (use the daily-recap skill), for looking up a single specific PR, commit, ticket, or document, for someone else's activity, for meeting recaps, for repository-level overviews, or for critiquing how a single Claude Code session went.

Use this Skill: https://skilld.dev/gh/bitwarden/ai-plugins/weekly-recap

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈219 tokens for metadata: the name and description. ≈1.1k when used: this file. ≈259 more on demand in 1 file.

Description uses 10.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈876 characters, or 10.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Weekly Recap

Generate the daily-recap page for a whole workweek. This skill defines only what differs for a week. Everything else comes from the daily-recap skill in the same plugin.

Using the daily-recap skill

Read ${CLAUDE_PLUGIN_ROOT}/skills/daily-recap/SKILL.md and follow its workflow (steps 1-7), its references/render-guide.md, and its rules on escaping, credentials, untrusted text, the Content-Security-Policy, and deleting work/. Where this file says something different, this file wins.

That file is read as plain text, so two things in it need translating:

  • Its relative paths (scripts/, assets/, references/) are under ${CLAUDE_PLUGIN_ROOT}/skills/daily-recap/. Call the scripts by that absolute path.
  • Its ${CLAUDE_PLUGIN_DATA} stays literal, because that file is read as plain text rather than loaded as a skill. Use the path substituted into this file: out_dir="${DAILY_RECAP_OUTPUT_DIR:-${CLAUDE_PLUGIN_DATA}/daily-recaps}". If the result still contains ${ or begins with /daily-recaps, the plugin data variable was empty; stop and report that this skill must run from the installed plugin.

The week

A week is the five workdays Monday through Friday. Each workday uses daily-recap's day boundary (DAILY_RECAP_CUTOFF_HOUR, default 07:00, and TZ), so the week runs from the cutoff on Monday to the cutoff on Saturday. Pick the dates, then take the actual bounds from the scripts' window output rather than recomputing them.

  • "last week", "weekly standup", or no time given: the most recent Monday-to-Friday week whose Friday workday has ended.
  • "this week": Monday of the current week through today. Today's window ends in the future, which is fine.
  • A specific date: the Monday-to-Friday week containing it.

To step between dates, source ${CLAUDE_PLUGIN_ROOT}/skills/daily-recap/scripts/date-utils.sh and use add_days, which handles GNU and BSD date. For a date's weekday, use epoch_fmt "$(local_to_epoch "YYYY-MM-DD 12:00:00")" '%u' (1=Monday) rather than date -d, which is GNU-only and silently returns today's weekday on BSD date.

Collecting

In daily-recap's step 1, run (a), (b), and (d) once per workday in the week, passing that day's date and naming each file by it (events-YYYY-MM-DD.json, sessions-YYYY-MM-DD.json, atlassian-YYYY-MM-DD.json). In (b), read the window bounds from that day's events-YYYY-MM-DD.json rather than the events.json the step names. Run (c) once for the whole week: gather-gh-search.sh MONDAY LAST-DAY, where LAST-DAY is Friday, or for "this week" the earlier of today and that week's Friday. Skip (e) and leave {{TODAY_BANNER}} empty: "this week" already covers today, and for a past week the banner would sit across a weekend gap.

GitHub's events feed holds only the last 300 events from the last 30 days, so a busy week can be truncated, and a week more than 30 days old has no events at all. When any day's feed_complete is false, say so in the recap and rely on search.json for PRs.

Merge the per-day session digests before step 4, and the remaining per-day results before step 5. A session or PR that spans several days is one item, and a stream can run across the whole week.

Rendering

  • Page file: recap-week-YYYY-MM-DD.html in $out_dir, named by Monday's date. Use this name in steps 6 and 7.
  • Page title: in the copied page, replace "Daily Recap" with "Weekly Recap" in the <title>, the "Engineering Daily Recap" header span, the "Daily Recap · Interactive" eyebrow, and the "Bitwarden · Engineering Daily Recap" footer. All four sit outside the <script> block, so the Content-Security-Policy hash is unaffected.
  • {{DATE}}: the range, for example 2026-10-19 – 2026-10-23.
  • {{STANDUP_PERIOD}}: Week · {range}.
  • {{STANDUP_LABEL_PAST}} is Last week and {{STANDUP_LABEL_NEXT}} is This week, per the render guide's Weekly column.
  • Stats sum across the week. Count each PR, repository, and session once, and follow the render guide's dedupe rules for Jira and Confluence.
  • Timeline: order events across the week and put a day divider before each day's events, using the After Midnight divider's markup with the text {Weekday} · {YYYY-MM-DD}. Each event's tl-time span reads {Ddd} {HH:MM} rather than {HH:MM}, so the day stays legible when the project or search filter hides the events under a divider. Leave out the After Midnight divider; post-midnight events stay under their workday.
  • The BLUF and Last week bullets summarize the week's main outcomes, not each day in turn.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning10d3 checks · Risk SAFE
  • Gen Agent Trust Hub10d

    This skill is a thin wrapper that aggregates daily activity reports into a weekly view. It reuses the logic and security controls of an existing daily-recap skill within the same plugin. No malicious patterns or security risks were identified.

  • Socket10d

    No alerts

  • Snyk10d

    Risk: MEDIUM · 1 issue

Signed by skilld at a11c77b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
context
fork
agent
general-purpose

README badge

README badge for bitwarden/ai-plugins/weekly-recap