agentleFS
Works-HQWorks-HQ/ai-brain-starter-pack/skills/weekly-update/SKILL.md

weekly-update

Skill3 starsChanged 3 months agoMITView on GitHub

Produce a compact company weekly update from current context, tasks, decisions, waiting-for items, and meeting notes. Use once a week. Triggers on "weekly update", "update the projects", and "run the weekly updates".

7 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Company mode: use this when operating-system/ exists with operating-system/GLOBAL_TASKS.md.

    line 16
  2. Very specific:

    Personal mode: use this when root-level TASKS.md and personal context files exist without the company operating system.

    line 17
  3. Distinctive:

    Both detected: ask which mode to use. Write nothing until the user chooses.

    line 18
  4. Distinctive:

    Do not create a structure just to make the skill run.

    line 21
  5. Distinctive:

    Read the top-level company signals:

    line 29
  6. Distinctive:

    If a source is missing, say so.

    line 39
  7. Distinctive:

    Keep it to one screen. Separate facts from inference.

    line 51
  8. Distinctive:

    After writing, return a short company-level read on the pattern across the work.

    line 57

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Weekly Update

Turn the week's scattered signals into one compact view of progress, open loops, risk, and the next move.

Done when: the approved dated section is added to operating-system/WEEKLY_UPDATE.md above the previous entries, or the user has a conversational summary in personal mode.

Detect the structure first

Inspect the current folder before planning any write.

  1. Company mode: use this when operating-system/ exists with operating-system/GLOBAL_TASKS.md.
  2. Personal mode: use this when root-level TASKS.md and personal context files exist without the company operating system.
  3. Both detected: ask which mode to use. Write nothing until the user chooses.
  4. Neither detected: say that this folder does not contain a recognised personal or company structure. Point the user to START-HERE. Write nothing.

Do not create a structure just to make the skill run.

Personal mode

The personal structure does not maintain a weekly-update file. Explain that this workflow belongs to the company level, point the user to the company setup, and write nothing. Offer a conversational summary only if the user wants one.

Company mode

Read the top-level company signals:

  • operating-system/current-context.md
  • operating-system/GLOBAL_TASKS.md
  • operating-system/DECISIONS.md
  • operating-system/WAITING_FOR.md
  • this week's files in operating-system/meetings/
  • the previous entry in operating-system/WEEKLY_UPDATE.md
  • any email or message exports the user explicitly provides

If a source is missing, say so. Do not infer activity from silence.

Draft one dated section with:

  • Status: Green, Amber, or Red, with one line explaining why
  • Since last week: progress, not activity
  • Open loops
  • Risks
  • Decisions needed and their owners
  • Follow-ups
  • Suggested next action: the single most important move

Keep it to one screen. Separate facts from inference. Where a source was quiet, say "no meaningful signal this week." Draft only, never send.

Approval gate

Show the complete proposed section and name operating-system/WEEKLY_UPDATE.md as the only target. Wait for approval. On approval, add the new dated section above the previous entries. If the file is missing and operating-system/templates/WEEKLY_UPDATE.md exists, propose creating it from that template first. Never replace or discard previous weeks.

After writing, return a short company-level read on the pattern across the work.

Scaling to per-project folders

Company mode deliberately writes one top-level operating-system/WEEKLY_UPDATE.md. If the organisation later needs separate project updates, create a WEEKLY_UPDATE.md inside each project and change this routing rule. Keep a short cross-project summary at the top level.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.