check-workspace

Solid

Use this skill to orient at session start, check initiative queue state, or see what's ready to work on next. Reads workspace.toml and surfaces ready-to-start items, blocked items with reason, parallel candidates, and active signals. Triggers on "check workspace", "what should I work on", "orient me", "session start", "what's ready", "show the queue", "workspace status", "what's next", or any cold-start orientation request. Offers to initialise workspace.toml if absent.

AI & Automation 14 stars 4 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 79/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Skill: check-workspace Read the local `workspace.toml` and surface the current queue state across all active initiatives. Run this at every session start — it replaces reading multiple product docs by hand. ## When to invoke Any time you need to orient: which initiative is active, what specs are ready to start, what is blocked and why, what signals the strategist has flagged. Also the right skill if workspace.toml does not yet exist and you want to initialise it. ## Procedure ### 1. Read workspace.toml Open `workspace.toml` from the repo root. Parse it as TOML (`tomllib.loads()` in Python 3.11+ / `tomli.loads()` backport for earlier). **If absent:** offer to initialise — ask the user whether to create a blank file or bootstrap with their first initiative. A blank file contains only the one-line comment: ```toml # workspace.toml — add ["<initiative-slug>"] sections to declare initiatives ``` **If present and unparseable:** surface the TOML parse error and stop — do not proceed with partial data. ### 2. Resolve the DAG For each initiative's `[work]` and `[shaping_queue]`: - A queue entry is **ready** when all its `needs` entries are satisfied (see below). - A queue entry is **blocked** when one or more `needs` entries are not yet satisfied. - An entry with no `needs` field is unconditionally ready (unless already in `active` or `shipped`). **Needs resolution:** `needs` is a string or list of strings using queue-prefix notation: | Prefix | Resolves against | |--...

Details

Author
eugenelim
Repository
eugenelim/agent-ready-repo
Created
2 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category