openyoko: Skill for Claude Code

/monthly-calls Skill

Generate a comprehensive monthly call summary for a project, aggregating patterns and building a narrative arc.

Usage

/monthly-calls <project> [month]

Examples:

• /monthly-calls acme - Summarize current/latest month's calls for Acme
• /monthly-calls techcorp 01 - Summarize January calls for TechCorp
• /monthly-calls acme 2026-03 - Specific year-month format

Arguments

• project (required): Project name (case-insensitive, matches folder in 03_PROJECTS/)
• month (optional): Month number (01-12) or ISO format (2026-01). Defaults to current/latest month with calls.

---

Instructions

When this skill is invoked, follow these steps:

Step 1: Locate Project

1. Find the vault at ../my-vault/ relative to personal-agent-os (typically /Users/username/Documents/projects/my-vault/)
2. Search 03_PROJECTS/ for a folder matching the project name (case-insensitive)
3. If not found, list available projects and ask user to clarify

Step 2: Determine Month Range

1. Parse the optional month argument:
   • If 01 or 1 format: interpret as current year's January
   • If 2026-01 format: use exact year-month
   • If no month specified: find the most recent month that has calls
2. Calculate the date range for that month (1st to last day)

Step 3: Check for Weekly Summaries

1. Look in Notes/ folder for existing weekly summary files matching pattern {{YYYY}}-W{{NN}}-calls.md
2. Filter to weeks that fall within the target month
3. If weekly summaries exist: use them as primary source (more efficient)
4. If not: fall back to scanning raw call files

Step 4: Gather Source Material

If using weekly summaries:

• Read each weekly summary for the month
• Extract already-synthesized decisions, insights, themes, momentum

If using raw calls:

• Read all files in Calls/ folder for the target month
• Parse dates from filenames (format: YYYY-MM-DD-*.md)
• Extract using the same logic as weekly-calls skill