Skip to main content
skill CX Codex

open — Claude Code skill: what it does, how to install

This Claude Code skill loads workspace context and surfaces items that need attention at the start of a session. Running /open checks priorities and recovers unfinished work.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill open -a claude-code
Open on GitHub

What open does

The skill starts a work session by reading notes, the session log, priorities, and runtime state, then reports only items that need attention. It checks aging decisions and drift between recent work and planned focus. Once a week, it scans for skill gaps and runs /skill-hunt on the oldest open one.

Before the main routine, it reads .aigent/state.json. If the status is not ready, it runs /start instead. It compares .aigent/last-close with recent Session Captures and writes recovered entries to vault/memory/SESSION_LOG.md. The skill is deprecated: /resume replaces it and runs automatically after a context clear.

The scripts require Node.js and Python 3, with AIGENT_ROOT pointing to the AIGENT root. The skill runs daemons/nightly-watchdog.mjs and daemons/runtime/update-active-state.py, and reads data under vault/ and .aigent/.

What it helps with

  • recover session notes left unbanked
  • find the next action in the session log
  • surface aging decisions and blocked work
  • compare recent activity with planned priorities

Example prompts for the agent

  • Open a work session and show what needs attention.
  • Run /open and recover any unfinished session work.
  • Start the session by checking priorities, blockers, and open decisions.

How to install open

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill open -a claude-code

2Manually: put the files in place

~/.claude/skills/open/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/open/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about open

How do I install open in Claude Code?

Run npx skills add wrg32786/aigent-os --skill open -a claude-code. The skill is installed at ~/.claude/skills/open/SKILL.md.

What does open do?

It loads workspace context and surfaces unfinished work, blockers, aging decisions, and priority drift. The skill is deprecated and superseded by /resume.

What does open need to run?

It needs Node.js, Python 3, and AIGENT_ROOT set to the AIGENT root. It reads files under vault/ and .aigent/.

Source text

SKILL.md · MIT
---
name: open
description: "Boot a session, load vault context, and surface what matters. Use when opening a session, saying good morning, or starting work."
trigger: /open
status: DEPRECATED by the two-verb lifecycle — see skills/resume/SKILL.md. /resume absorbs /open; the post-clear boot runs it automatically via daemons/resume-verb.mjs. Kept for manual invocation during the transition; not deleted.
---

# Session Open

> **Deprecated.** This skill is superseded by [[skills/resume/SKILL.md|/resume]] (docs/two-verb-lifecycle.md). New installs should reach for `/resume`; this file stays for anyone still invoking `/open` by habit during the transition.

Run this at the start of every normal working session.

## Nightly alert surface

Before normal orientation, run the local watchdog with the same configured time
zone and cutoff used by the pass:

```text
node daemons/nightly-watchdog.mjs --root <aigent-root>
```

Surface every active named alert from
`vault/memory/runtime/NIGHTLY_ALERTS.jsonl`. The append-only ledger and stderr
are the default delivery channels; no external coordination service is
required. If the ledger is unreadable, report `ALERT_LEDGER_INVALID` and
continue the resume path. An alert-read failure must never suppress session
orientation or make the hook indistinguishable from "not installed."

## First-run detection

Before the normal protocol, read `.aigent/state.json`.

- If `status` is not `ready`, run `/start` instead of the normal open protocol.
- If the JSON state is missing but `.aigent/first-run-done` exists, treat the installation as ready and create the JSON state as a compatibility migration.
- Do not inspect natural-language placeholders in `system/00_identity.md`. Product state belongs in machine-readable state, not in whether a sentence happens to survive an edit.

## Protocol

**Unbanked-session recovery:** Compare `.aigent/last-close`, if present, with the newest Session Captures in `vault/daily/`. If newer captures exist, recover a short summary into `vault/memory/SESSION_LOG.md`, mark it `(auto-recovered)`, and continue. State the recovery in one neutral line.

1. **Load the heat index** from `vault/memory/HEAT_INDEX.json` when present. Use `hot_top_20` as the prioritized reading list. If missing, use steps 2 through 6 normally.
2. **Read the latest daily note** in `vault/daily/`.
3. **Read the session log** at `vault/memory/SESSION_LOG.md` and extract the newest next action and open threads.
4. **Read active priorities** at `vault/memory/ACTIVE_PRIORITIES.md`.
5. **Follow the graph** from the latest daily note and open threads into the three to five most relevant project, concept, person, or agent notes.
6. **Check delegation** at `vault/memory/DELEGATION_TRACKER.md` for blocked, stale, or review-ready work.
7. **Decision aging**: compare `vault/memory/DECISION_LOG.md` and `vault/memory/DECISION_OUTCOMES.md`. Surface at most three unresolved decisions around 30, 60, or 90 days old.
8. **Attention reconciliation**: compare the last seven days in `vault/daily/` with intended focus in `vault/memory/ACTIVE_PRIORITIES.md`. Surface material drift only.
9. **Skill gap scan**: once per week, inspect `memory/SKILL_GAPS.md`. If an open gap is older than seven days, run `/skill-hunt` on the oldest one and update the ledger if resolved.
10. **Compute runtime state**:

```bash
python3 "$AIGENT_ROOT/daemons/runtime/update-active-state.py"
```

11. **Read runtime state** at `vault/memory/runtime/ACTIVE_STATE.json`. Use `next_valid_action`, `blocked_items`, active reflexes, and mode to orient the session.
12. **Reconcile weekly**: on Monday or after seven days without a reconciliation, run `/reconcile` and surface contradictions only.

## Output

Give a brief greeting, then surface only:

- Due decision-aging prompts.
- Material attention drift.
- Stale or blocked items.
- Work dropped from the previous next action.
- Open threads requiring attention now.

If nothing needs flagging, greet the operator and let them drive. Do not dump a full priority report merely because the files exist.

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

SKILL.md skills catalog →
open-knowledge-discovery Inkeep open-knowledge-discovery explains how OpenKnowledge works, guides repository setup with ok init, and previews loose Markdown files in a temporary session without touching repository files. CX Codex +1 15,300installs open-source-company-strategy Samuel Berthe open-source-company-strategy — a skill that walks a company through deciding which assets ship under an open license and which stay closed. Useful when the question is framed as one big yes or no. CX Codex +1 13,800installs open-standards-strategy Samuel Berthe open-standards-strategy is a Claude Code skill for choosing a company’s stance on a named open specification or protocol. It engages in discussions about standards participation, interoperability, or a rival spec. CX Codex +1 13,700installs open-code-review alibaba open-code-review is a Claude Code skill that reviews workspace edits, commits, pull requests, and branch diffs. It reports line-level findings and explains the impact of committed changes by default. CX Codex +1 8,200installs open-knowledge-write-skill Inkeep open-knowledge-write-skill — a skill that walks the agent through authoring a new SKILL.md: picking scope, writing frontmatter, and checking that it triggers when it should. CX Codex +1 6,900installs onchain-pay-open-api onchain-pay-team Skill for calling Binance Onchain-Pay Open API endpoints with RSA SHA256 request signing. Enables crypto purchases with fiat directly to external wallets. CX Codex +1 6,100installs

From the same set58

The whole set →
port-spec The port-spec Claude Code skill turns a complete written specification into code or a vault artifact. It activates for spec implementation, brief-based builds, and ports from specs. CX Codex +1 ★ 26repo stars pause The pause Claude Code skill saves a task’s state when work needs to stop temporarily. The next session offers a way to resume it. CX Codex +1 ★ 26repo stars orient The orient Claude Code skill points to the project map section relevant to a question about structure, ownership, rules, or next steps. It activates when someone asks where to look or how to proceed. CX Codex +1 ★ 26repo stars operator-setup The operator-setup Claude Code skill interviews a business operator and saves the answers for later sessions. It turns the stated goals and time-consuming work into three tailored next steps. CX Codex +1 ★ 26repo stars nightly This Claude Code skill runs a nightly project-state protocol and records its checkpoints. Start the full pass with /nightly-close-parity. CX Codex +1 ★ 26repo stars nightly-ledger-capture The nightly-ledger-capture Claude Code skill stages candidates for honesty, trust-decay, failure-mode, and decision-outcome records. It gathers local evidence from logs and Git; a human gate controls writes. CX Codex +1 ★ 26repo stars nightly-close-parity This skill for Claude Code runs a project’s nightly close-parity maintenance. It checks the local route first, then follows the protocol stored in the project. CX Codex +1 ★ 26repo stars meta-improve A Claude Code skill applies operator-approved Dream candidates through a gated change process. Run it with /meta-improve-vault before building the change. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open