GA Product Update Skill

This package installs a Codex/Claude skill that helps you write weekly product/project updates from a rough brain dump.

The skill remembers each project over time:

• project/product OKRs
• optional CC recipients
• raw weekly dumps
• final weekly updates
• last week's committed actions

At the end of each weekly flow, it creates an Outlook Web draft link and a local launcher page with the full email body.

What It Is For

Use this for weekly updates on product or project work, especially Speed Mode projects where we want to learn quickly from users.

The skill helps you answer:

• What changed this week?
• Are we on track against the OKRs?
• What shipped?
• What did we learn from users?
• What decisions did we make?
• What is blocked?
• What are next week's concrete actions?
• Should we continue, stop, reframe, or move to Scale Mode?

Requirements

• Node.js 18+
• Python 3
• Codex or Claude with local skills support
• Outlook Web access in your browser

Install

Install the npm package globally:

npm install -g ga-product-update

Then install the skill into Codex:

ga-product-update install --target codex --recipient "<weekly-update-recipient-email>"

Or install it into Claude:

ga-product-update install --target claude --recipient "<weekly-update-recipient-email>"

Or install it into both:

ga-product-update install --target both --recipient "<weekly-update-recipient-email>"

Restart Codex or Claude after installing.

First Use For A Project

Start a new chat and invoke the skill:

$ga-product-update

On the first run, the skill will ask you to set up the project:

1. What project/product is this update for?
2. If you already have OKRs, paste the OKR.md here.
3. If you don't have OKRs yet, say "help me".

If you already have OKRs, paste them.

If you do not have OKRs yet, say:

help me

The skill will ask guided questions. Use the voice feature in Codex/ChatGPT or Claude if that is easier. A rough voice dump is fine; the skill will synthesize the first okr.md draft for you to review.

Weekly Use

Start a chat:

$ga-product-update update for [Project Name]

The skill will read the saved OKRs and last weekly update, then ask you to brain dump this week's update.

You can answer in rough notes or use voice. Include:

• whether last week's actions were completed
• what shipped
• user feedback or learning
• OKR progress
• decisions made
• blockers or risks
• 1-3 concrete actions for next week
• what help you need
• whether the project should continue, stop, reframe, or move to Scale Mode

The skill may ask one or two follow-up questions if something important is unclear.

Optional CCs

The first time you write an update for a project, the skill may ask whether anyone should be CC'd.

You can say:

no CCs

Or provide emails:

CC [email protected] and [email protected]

The skill saves this project preference so it does not ask every week.

Outlook Web Drafts

At the end of the flow, the skill generates:

• an Open Outlook Web draft link
• a Copy Outlook Link button in the launcher page
• a primary button that opens Outlook Web and copies the Cc list as a backup
• a Copy CC button in case Outlook Web does not prefill Cc
• a local launcher page
• the saved update file path

Use the Outlook Web draft link first.

If the launcher opens inside Codex or Claude instead of your normal browser, click Copy Outlook Link and paste it into your browser.

If Outlook Web opens but Cc is empty, paste the copied Cc value into Outlook's Cc field. You can also click Copy CC in the launcher page again.

If Outlook Web drops part of the body or the link does not open correctly, open the local launcher page and click Copy Full Body, then paste the full update into Outlook Web.

Memory Location

The skill stores project memory locally.

Codex:

~/.codex/skills/ga-product-update/memory/projects/[project-slug]/

Claude:

~/.claude/skills/ga-product-update/memory/projects/[project-slug]/

Each project folder contains:

okr.md
email.md
raw/YYYY-MM-DD.md
updates/YYYY-MM-DD.md
updates/YYYY-MM-DD-outlook.html

Troubleshooting

If the skill is not found, restart Codex or Claude after installing.

If Outlook Web does not open, use the local launcher page generated by the skill.

If the update body is incomplete in Outlook Web, use the launcher page's Copy Full Body button.

If the skill asks for OKRs again, check that you are using the same project name as before.

If you need to change CCs, tell the skill:

change CCs for [Project Name]

Local Test Install

If you have a local package tarball instead of the published npm package:

npm install -g ./ga-product-update-0.1.0.tgz
ga-product-update install --target codex --recipient "<weekly-update-recipient-email>"