agentleFS
kv0906kv0906/pm-kit/.claude/skills/today/SKILL.md

today

Skill138 starsChanged 7 months agoMITView on GitHub

Guided daily workflow orchestrator. Multi-phase process (standup, team sync, review, focus, wrap-up). Use when user says "today", "start my day", or "daily workflow".

We split this skill into the rules it gives an agent

19 rules. 0 are common, 11 are distinctive, and 8 are very specific to this project.

  • 0

    Common

    Most of the 14 edited versions we read keep these.

  • 11

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No args: Start from Phase 1, or resume current phase (detect via TaskList)

    line 32
  2. Distinctive:

    Create all phase tasks upfront with dependencies:

    line 39
  3. Very specific:

    Before creating tasks, check TaskList for existing /today phase tasks:

    line 73
  4. Very specific:

    If tasks exist with in_progress status → resume from that phase

    line 75
  5. Distinctive:

    If Phase 4 was completed → start Phase 5 (wrap-up)

    line 76
  6. Distinctive:

    If all phases completed or no tasks exist → start fresh from Phase 1

    line 77
  7. Very specific:

    Read _core/config.yaml → get active projects list

    line 89
  8. Very specific:

    Create or update daily/{date}.md:

    line 102
  9. Very specific:

    If file exists: update each project's ## {Project Name} section

    line 103
  10. Distinctive:

    If new: create from template with all project sections

    line 104
  11. Distinctive:

    If similar exists: link to it

    line 108
  12. Very specific:

    If NEW: prompt user — "Blocker detected: '{text}'.

    line 109
  13. Very specific:

    y: Create with severity=medium at blockers/{project}/{date}-{slug}.md

    line 110
  14. Distinctive:

    If skip → mark phase complete, advance to Phase 3

    line 142
  15. Distinctive:

    Create appropriate notes with links

    line 150
  16. Very specific:

    After processing, ask: "More to process?

    line 151
  17. Distinctive:

    Empty vault (no daily note): Create fresh daily note in Phase 1

    line 283
  18. Distinctive:

    QMD not available: Not needed (direct file scans only)

    line 291
  19. Distinctive:

    Obsidian not running: No impact (terminal-only output)

    line 292

“Common” is measured: kept by at least 6 in 10 of the 14 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

/today — Daily Workflow Orchestrator

Guides PMs through a structured daily routine: standup → team sync → review → focus → wrap-up. Reuses existing skill logic (/daily, /meet, /progress) — does NOT duplicate it.

Context

Today's date: !date +%Y-%m-%d Existing daily: !ls daily/*.md 2>/dev/null | tail -5

Config: @_core/config.yaml Processing logic: @_core/PROCESSING.md Daily template: @_templates/daily.md

Reference skills (for reuse patterns):

  • @.claude/skills/daily/SKILL.md — keyword detection, blocker/decision logic
  • @.claude/skills/meet/SKILL.md — meeting note parsing
  • @.claude/skills/progress/SKILL.md — dashboard aggregation

Input

User input: $ARGUMENTS

Argument Handling

  • No args: Start from Phase 1, or resume current phase (detect via TaskList)
  • status: Show which phase is currently active
  • skip: Skip current phase, advance to next
  • wrap: Jump directly to Phase 5 (wrap-up)

Session Task Progress

Create all phase tasks upfront with dependencies:

TaskCreate: "Phase 1: Daily Standup"
  description: "Capture updates for all active projects"
  activeForm: "Running daily standup..."

TaskCreate: "Phase 2: Team Sync"
  description: "Process external context (Slack, meetings, Linear)"
  activeForm: "Processing team sync..."

TaskCreate: "Phase 3: Review"
  description: "Display cross-project health dashboard"
  activeForm: "Generating review dashboard..."

TaskCreate: "Phase 4: Focus"
  description: "Display priorities and pause for deep work"
  activeForm: "Setting focus priorities..."

TaskCreate: "Phase 5: Wrap-Up"
  description: "Summarize the day"
  activeForm: "Wrapping up the day..."

Set dependencies:

TaskUpdate: Phase 2, addBlockedBy: [phase-1-id]
TaskUpdate: Phase 3, addBlockedBy: [phase-2-id]
TaskUpdate: Phase 4, addBlockedBy: [phase-3-id]
TaskUpdate: Phase 5, addBlockedBy: [phase-4-id]

Resume Logic (Same Session Only)

Before creating tasks, check TaskList for existing /today phase tasks:

  • If tasks exist with in_progress status → resume from that phase
  • If Phase 4 was completed → start Phase 5 (wrap-up)
  • If all phases completed or no tasks exist → start fresh from Phase 1

No persistent state files. The file system is the state — daily notes exist or they don't.


Phase 1: DAILY STANDUP (Interactive)

Purpose: Capture updates for all active projects.

Steps

  1. Read _core/config.yaml → get active projects list
  2. For each active project, prompt the user:

    {project_name}: What's your update? (shipped/wip/blocked)
  3. Parse each response using keyword detection (from /daily skill):
    • Shipped: shipped, done, completed, finished, merged, deployed, released
    • WIP: wip, working on, in progress, continuing, started, ongoing
    • Blocked: blocked, stuck, waiting on, waiting for, need from, dependency
    • Decided: decided, going with, chose, selected, agreed
  4. Create or update daily/{date}.md:
    • If file exists: update each project's ## {Project Name} section
    • If new: create from template with all project sections
  5. Auto-detect blockers (per /daily logic):
    • For each blocked item: search blockers/{project}/*.md for similar open blockers
    • If similar exists: link to it
    • If NEW: prompt user — "Blocker detected: '{text}'. Create blocker note? (y/n/details)"
      • y: Create with severity=medium at blockers/{project}/{date}-{slug}.md
      • details: Prompt for severity, owner, due date
      • n: Skip
  6. Auto-detect decisions:
    • For each decision keyword: suggest creating a decision note
    • Link to daily if user confirms

Output

✓ Updated daily/{date}.md ({count} projects)
  - Shipped: {count} items
  - WIP: {count} items
  - Blockers: {count} (linked/created)
  - Decisions: {count} (detected)

Phase 2: TEAM SYNC (Interactive)

Purpose: Process external context (Slack threads, Linear updates, meeting notes).

Steps

  1. Prompt the user:

    Any team updates, Slack threads, or meeting notes to process? (paste or 'skip')
  2. If skip → mark phase complete, advance to Phase 3
  3. If content provided:
    • Classify content type using keyword detection:
      • Meeting signals → route as meeting note (use /meet patterns)
      • Blocker signals → route as blocker
      • Decision signals → route as decision
      • General → route to inbox
    • Create appropriate notes with links
    • After processing, ask: "More to process? (paste or 'done')"
    • Loop until user says 'done' or 'skip'

Output

✓ Team sync complete
  - Meeting notes: {count}
  - Blockers: {count}
  - Items routed: {count}

Phase 3: REVIEW (Auto-generated, Read-only)

Purpose: Display a cross-project health dashboard. No files created.

Steps

  1. Scan vault and aggregate:
    • Open blockers: Glob blockers/{project}/*.md for each active project, read frontmatter for severity/due
    • Critical items: Blockers with due date < 2 days from today (per defaults.blocker_critical_days)
    • Active docs: Glob docs/{project}/*.md, filter status != shipped
    • Recent decisions: Glob decisions/{project}/*.md from last 3 days
  2. Display formatted dashboard to terminal:
┌─────────────────────────────────────┐
│  TODAY'S DASHBOARD — {date}         │
└─────────────────────────────────────┘

BLOCKERS (by severity)
  🔴 High ({count})
    • [{project}] {title} — due {date}

  🟡 Medium ({count})
    • [{project}] {title}

  🟢 Low ({count})
    • [{project}] {title}

  (None) — if no blockers exist

ACTIVE DOCS
  • [{project}] {title} — {status}

  (None) — if no active docs

RECENT DECISIONS (last 3 days)
  • [{project}] {title} — {date}

  (None) — if no recent decisions

Output

Dashboard displayed to terminal. No files created.


Phase 4: FOCUS (Display & Pause)

Purpose: Show priorities and let the user do deep work.

Steps

  1. Extract priorities from today's daily note:
    • Top 3 WIP items across all projects
    • Critical blockers to address (from Phase 3 data)
    • Pending decisions (if any detected)
  2. Display priority list:
TODAY'S PRIORITIES
━━━━━━━━━━━━━━━━━━━━━━━━

1. [{project}] {wip item}
2. [{project}] {wip item}
3. [{project}] {wip item}

⚠ NEEDS ATTENTION
  • {critical blocker or pending decision}

━━━━━━━━━━━━━━━━━━━━━━━━
Focus time — run /today again when ready to wrap up
  1. Mark Phase 4 as complete. Exit workflow. User returns when ready.

Phase 5: WRAP-UP (Auto-generated, Read-only)

Purpose: Summarize the day. No files created.

Steps

  1. Re-read today's daily note (daily/{date}.md)
  2. Scan for blockers created/resolved today
  3. Scan for decisions made today
  4. Display summary:
TODAY'S SUMMARY — {date}
━━━━━━━━━━━━━━━━━━━━━━━━

SHIPPED ({count})
  • [{project}] {item}

IN PROGRESS ({count})
  • [{project}] {item}

BLOCKERS
  Created: {count}
  Resolved: {count}

DECISIONS MADE ({count})
  • [{project}] {title}

━━━━━━━━━━━━━━━━━━━━━━━━
Run /push to commit today's updates

Edge Cases

  • No projects configured: Display error — "No active projects in config.yaml. Run /onboard to set up your first project."
  • Empty vault (no daily note): Create fresh daily note in Phase 1
  • No blockers/decisions/docs: Display "(None)" in dashboard sections
  • User exits mid-phase: Session tasks preserve progress for same-session resume
  • /today wrap with no daily note: Display message — "No daily note for today. Run /today to start your day first."

Graceful Degradation

  • Linear MCP not connected: Skip auto-fetch, continue with paste-only in Team Sync
  • QMD not available: Not needed (direct file scans only)
  • Obsidian not running: No impact (terminal-only output)

Integration

Works with:

  • /daily — Reuses keyword detection and blocker/decision logic
  • /meet — Routes meeting content in Team Sync phase
  • /progress — Similar dashboard pattern in Review phase
  • /push — Suggested at wrap-up for committing changes
  • /block — Blocker creation follows same patterns
  • /decide — Decision creation follows same patterns

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.

Reviews can't be read right now.

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.