skills/by-role/pm/pm-weekly-update/SKILL.md
Generate weekly or monthly status updates from local PM data. Use this skill when: - It's end of week and you need a status update for leadership or stakeholders - You need a monthly executive summary - You want to draft an email update using data from meetings, tracker tickets, and decisions - The user says "weekly update", "status report", "what happened this week?", "weekly summary" - The user says "Friday update", "send status email", "EOW update" Pulls from work logs, meetings, ticket tracker, and decisions — no manual input needed.
npx skillsauth add qa-aman/claude-skills pm-weekly-updateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Generate structured status updates by reading local PM data from .local/. No manual input needed — everything is pulled from synced data.
Before generating an update, ensure data is fresh:
/pm-sync if available)If data looks stale (e.g., sprint file is from 3 days ago), warn the user and offer to sync first.
Read these files from .local/:
| Source | File | What to Extract |
|--------|------|-----------------|
| Sprint progress | tracker/sprints/<active-sprint>.md | Points done vs total, issues moved |
| Meetings | meetings/processed/*.md (this week only) | Meeting count, key discussions |
| Action items | meetings/meeting-action-items.md | New items this week, closed items |
| Decisions | decisions/decision-log.md | Decisions made this week |
| Epics | tracker/epics.md | Epic-level progress |
Also cross-reference meetings for this week to ensure completeness (list meetings with a this_week time range, compare against processed files).
Also pull from the ticket-tracker API directly for most current data:
project = [PROJECT_KEY] AND created >= startOfWeek()project = [PROJECT_KEY] AND resolved >= startOfWeek()project = [PROJECT_KEY] AND status = "In Progress"Write to .local/updates/weekly/YYYY-WNN.md:
# Weekly Update — Week N (Mon DD – Fri DD, Month YYYY)
> Project: [your project] ([PROJECT_KEY])
> Author: [your name]
> Generated: DD-MM-YYYY
## Sprint Progress: "<Sprint Name>"
- **Velocity**: X/Y story points completed (Z%)
- **Issues**: A done, B in progress, C to do (of D total)
### Completed This Week
| Key | Summary | Type | Points |
|-----|---------|------|--------|
| [PROJECT-XX] | ... | Story | 3 |
### In Progress
| Key | Summary | Assignee | Points |
|-----|---------|----------|--------|
| [PROJECT-XX] | ... | Name | 5 |
### Blocked / At Risk
| Key | Summary | Blocker |
|-----|---------|---------|
<!-- If any -->
## Key Decisions
| Decision | Context | Date |
|----------|---------|------|
| ... | From meeting X | Mon |
## Meetings This Week
- **Mon**: <Meeting title> — <1-line summary>
- **Tue**: <Meeting title> — <1-line summary>
- ...
## Action Items Status
- **New this week**: X items
- **Closed this week**: Y items
- **Still open**: Z items
## Risks & Blockers
<!-- From decisions log and meetings -->
## Next Week Focus
<!-- Infer from in-progress items and upcoming meetings -->
Also produce a short version for Slack/email at the bottom of the file:
---
## Slack / Email Version
**[your project] — Week N Update**
Sprint: X/Y pts done (Z%)
- <Top 3 things completed>
- <Top 3 things in progress>
- <Any blockers>
Decisions: <1-2 key decisions>
Next week: <Focus areas>
After generating, ask:
.local/mail/drafts/weekly-YYYY-WNN.mdWhen the user asks for a monthly summary:
.local/updates/weekly/ for the monthWrite to .local/updates/monthly/YYYY-MM.md:
# Monthly Executive Summary — <Month YYYY>
> Project: [your project] ([PROJECT_KEY])
> Author: [your name]
## Highlights
- <Top 3-5 achievements this month>
## Sprint Summary
| Sprint | Planned (pts) | Completed (pts) | Velocity |
|--------|--------------|-----------------|----------|
| Sprint N | X | Y | Z% |
## Key Metrics
- **Tickets created**: X
- **Tickets resolved**: Y
- **Story points delivered**: Z
- **Active epics**: N
## Major Decisions
| Decision | Date | Impact |
|----------|------|--------|
| ... | ... | ... |
## Risks & Mitigations
| Risk | Status | Mitigation |
|------|--------|------------|
## Next Month Focus
- <Planned epics/features>
- <Key milestones>
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.