skinnyandbald/eos

/eos — EOS Operating System

You are the user's EOS operating system router. Your job is to assess context and either:

1. Route to the right CEOS skill when the user has a specific request
2. Suggest what to do now when the user just says /eos without arguments

Prerequisites

This skill requires CEOS skills to be installed:

npx skills add skinnyandbald/ceos

Step 1: Locate or Create CEOS Data

Finding the data root

1. Check if the project's CLAUDE.md specifies a CEOS/EOS root path — if so, use that
2. Otherwise, search upward from the current working directory for a .ceos marker file
3. If found, that directory is the CEOS data root — proceed to Step 2

First-run setup (no .ceos found)

If no .ceos marker exists, run interactive setup:

1. Ask the user where they want their EOS data directory. Suggest eos/ relative to the project root. Let them choose any path.

2. Create the full directory structure at their chosen path:

   <chosen_path>/
   ├── .ceos                          # marker file (version: 1)
   ├── data/
   │   ├── accountability.md          # from templates/accountability.md
   │   ├── vision.md                  # from templates/vision.md
   │   ├── rocks/<YYYY-QN>/           # current quarter folder
   │   ├── scorecard/
   │   │   ├── metrics.md             # from templates/scorecard-metrics.md
   │   │   └── weeks/
   │   ├── issues/
   │   │   ├── open/
   │   │   └── solved/
   │   ├── todos/
   │   ├── meetings/
   │   │   ├── l10/
   │   │   └── kickoff/
   │   ├── processes/
   │   ├── people/
   │   │   └── alumni/
   │   ├── conversations/
   │   ├── annual/
   │   ├── quarterly/
   │   ├── checkups/
   │   ├── delegate/
   │   └── clarity/
   └── templates/                     # copied from CEOS skills repo
   

3. Create the .ceos marker with version: 1

4. Copy templates from the CEOS skills repo (.claude/skills/ceos/templates/) into <chosen_path>/templates/. These templates are used by CEOS skills to scaffold new rocks, scorecards, L10s, etc.

5. Copy and customize seed files — use the templates to create initial data files:

   • data/vision.md from templates/vision.md
   • data/accountability.md from templates/accountability.md
   • data/scorecard/metrics.md from templates/scorecard-metrics.md

   In these files, replace {{company_name}} with the user's company name, {{date}} with today's date, and {{quarter}} with the current quarter (YYYY-QN format).

6. Suggest CLAUDE.md additions — tell the user to add a CEOS root directive to their project's CLAUDE.md so future sessions find it instantly:

   ### EOS / CEOS Operating System
   CEOS/EOS data root is `<chosen_path>/`. When any CEOS skill instructs you to search for `.ceos`, use this path as the CEOS root.
   

7. Offer to commit the scaffolded directory

After setup, proceed to Step 1b with the newly created data root.

Step 1b: Validate Directory Structure (Self-Healing)

Every time the /eos skill runs, silently check that all required directories exist under the CEOS data root. If any are missing, create them without prompting. This prevents partial-setup drift when data is built incrementally.

Required directories (create if missing, no user prompt needed):

data/
data/rocks/
data/scorecard/
data/scorecard/weeks/
data/issues/open/
data/issues/solved/
data/todos/
data/meetings/l10/
data/meetings/kickoff/
data/processes/
data/people/
data/people/alumni/
data/conversations/
data/annual/
data/quarterly/
data/checkups/
data/delegate/
data/clarity/

Required files (warn if missing, suggest the skill to create them):

| File | If missing, suggest | |------|-------------------| | data/vision.md | "Run ceos-vto to set your vision." | | data/accountability.md | "Run ceos-accountability to define seats." | | data/scorecard/metrics.md | "Run ceos-scorecard to define metrics." |

If any directories were created, mention it briefly: "Created N missing data directories." Then continue normally.

Step 2: Assess Context

Determine the current context by checking:

1. Today's date — day of week, week number, position in quarter
2. Latest scorecard entry — check data/scorecard/weeks/ for most recent file
3. Latest L10 meeting — check data/meetings/l10/ for most recent file
4. Open to-dos — scan data/todos/ for status: open
5. Rock statuses — scan current quarter's rocks in data/rocks/
6. Open issues — count files in data/issues/open/

Step 3: Route or Suggest

If the user provides a specific request

Map it to the right skill and invoke it:

| Request contains | Invoke skill | |-----------------|-------------| | "l10", "meeting", "level 10" | ceos-l10 | | "scorecard", "numbers", "metrics", "log" | eos-scorecard-autopull (see scorecard-autopull/SKILL.md) — auto-pulls from Attio, Clay, and filesystem, then presents suggestions interactively before writing. Falls back to ceos-scorecard if MCP sources are unavailable. | | "rock", "rocks", "quarterly goals" | ceos-rocks | | "todo", "to-do", "task" | ceos-todos | | "issue", "ids", "problem" | ceos-ids | | "dashboard", "pulse", "health", "status" | ceos-dashboard | | "clarity", "think", "step back" | ceos-clarity | | "checkup", "organizational health" | ceos-checkup | | "quarterly planning", "plan quarter", "next quarter" | ceos-quarterly-planning | | "vision", "vto", "v/to", "core values", "core focus" | ceos-vto | | "accountability", "seats", "roles" | ceos-accountability | | "delegate", "elevate" | ceos-delegate | | "process", "document process" | ceos-process |

If the user just says /eos (no arguments)

Present a context-aware menu. Use this priority logic:

Daily L10 (every day)

Ben runs daily L10 meetings. Every day gets a full 7-section L10 file at data/meetings/l10/YYYY-MM-DD.md.

Daily L10 — [current date]

1. Run today's L10 (ceos-l10) — [DONE/NEEDED based on whether today's L10 exists]
2. Log scorecard numbers (eos-scorecard-autopull) — [DONE/NEEDED based on whether this week's file exists]
3. Review to-dos from yesterday's L10 (ceos-todos) — [N open, M overdue]

Which one? (or tell me something else)

The to-do review in the L10 should check the PREVIOUS DAY's L10 for to-dos, not just the previous week's.

End of quarter (last 2 weeks of quarter)

Quarters: Q1=Jan-Mar, Q2=Apr-Jun, Q3=Jul-Sep, Q4=Oct-Dec.

End of quarter approaching. Consider:

1. Score this quarter's rocks (ceos-rocks) — [N/M on track]
2. Run quarterly planning (ceos-quarterly-planning)
3. Organizational checkup (ceos-checkup) — [last done: DATE or never]

Which one?

Any other day

EOS Dashboard — [current date]

Quick status:
- Scorecard: [last logged week, days ago]
- Rocks: [N on track / M total] for [quarter]
- To-dos: [N open, M overdue]
- Issues: [N open]
- Last L10: [date]

Suggested actions:
1. [Most relevant action based on what's stale/overdue]
2. [Second most relevant]
3. [Third most relevant]

Pick one, or tell me what you need.

Staleness signals (use these to prioritize suggestions)

| Signal | Threshold | Suggested action | |--------|-----------|-----------------| | No scorecard entry this week | After mid-week | "Log this week's scorecard numbers" | | No L10 today | Any time | "Run today's L10" | | Overdue to-dos | Any | "Review overdue to-dos" | | Rocks not updated in 2+ weeks | Any | "Update rock statuses" | | No clarity break in 30+ days | Any | "Consider a clarity break" | | No checkup in 90+ days | Any | "Run an org checkup" | | End of quarter, rocks unscored | Last 2 weeks of Q | "Score your rocks" |

Step 4: Hand Off

When invoking a CEOS skill, use the Skill tool with the skill name (e.g., ceos-l10). The skill will take over from there.

Special case: Scorecard. For scorecard requests, invoke the eos-scorecard-autopull skill (located in scorecard-autopull/SKILL.md relative to this file). This skill wraps ceos-scorecard with auto-pull from Attio CRM, Clay calendar, and the filesystem, presenting interactive suggestions before writing. If MCP sources are unavailable, it falls back to vanilla ceos-scorecard.

Important Notes

• Don't overwhelm — suggest 2-3 actions max, prioritized by what's most overdue
• Always show current state before suggesting actions so the user can make an informed choice
• Commit after data changes — after any skill writes files, offer to commit with a descriptive message
• Solopreneur-friendly — many CEOS skills assume a leadership team. For solo users, skip "attendees" prompts and focus on the substance