Show read-only build-plan progress, active steps, git state, drift warnings, and the next action.

MITAuto-check passedDevelopment

Install Status

skills CLI
$ npx skills add aiblueprinthq/ai-blueprint --skill status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiblueprinthq/ai-blueprint status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiblueprinthq/ai-blueprint.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/status .claude/skills/status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
status
GitHub stars
463
Token cost
~2.4k tokens
SKILL.md length
1,358 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Show read-only build-plan progress, active steps, git state, drift warnings, and the next action.

  • Works in 9 steps: Project configuration - read… → Build plan - blueprint/build-plan.md.… → Current work -… → …
  • What is in progress
  • SKILL.md covers Input, What it reads, Output and Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Status is an agent skill from aiblueprinthq/ai-blueprint. Show read-only build-plan progress, active steps, git state, drift warnings, and the next action. Use for /status, what is in progress, what comes next, or resuming after a break or context clear.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git. The repository describes itself as: A file-backed, spec-driven AI coding workflow framework for building real software while staying in control. The licence is MIT.

When your agent uses it

  • What is in progress
  • What comes next
  • Resuming after a break

Example prompts

  • “/status”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Project configuration - read blueprint/config.json when present. Report
  2. Build plan - blueprint/build-plan.md. Count checked vs unchecked leaf
  3. Current work - blueprint/context/current-feature.md. Is something in
  4. Findings - blueprint/context/findings.md. Count findings by status and
  5. Independent review - blueprint/context/review.md. Report none, pending,
  6. Overview freshness - if blueprint/context/project-overview.md is missing
  7. Git - current branch, whether the working tree is clean or has uncommitted
  8. Progress drift - flag active spec on main, a spec in progress but no
  9. Dashboard activity - read blueprint/.state/run.json when it exists.

What it can do on your machine

Read from SKILL.md and the folder at commit 96222b7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Status loads about 2.4k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 1,358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aiblueprinthq/ai-blueprint at commit 96222b7, republished under its MIT licence (© aiblueprinthq). 1,358 words, ~2,435 tokens.

Download SKILL.mdSave it as .claude/skills/status/SKILL.md (or your agent's skills folder).
name
status
description
Show read-only build-plan progress, active steps, git state, drift warnings, and the next action. Use for /status, what is in progress, what comes next, or resuming after a break or context clear.

status - where the project stands right now

Context reuse: Reuse any required file already loaded in project instructions or the current session. Read it again only if absent, changed, or exact current bytes or line references are needed.

Where this sits in the workflow:

any time  ->  [status]  ->  reads build-plan + current-feature + git
              (read-only)   prints a short "you are here"

This skill answers one question: where am I? It reads the files that already track progress and prints a short orientation. It is the fast way back in after a break, a context clear, or a day away. It never changes anything: no edits, no commits, no installs, no builds, no branch changes.

Progress in this workflow lives in files, not the chat, so everything this skill reports comes from disk and git. That is the point: a fresh session can run /status and know exactly as much as the last one did.

For setup problems, missing files, placeholder plans, adapter drift, or questions about whether the Blueprint is installed correctly, run /doctor instead.

Input

None. /status takes no argument.

What it reads

Gather these, then summarize. Don't dump file contents; report the distilled state.

  1. Project configuration - read blueprint/config.json when present. Report project settings, built-in defaults, or invalid, using defaults. A missing file is healthy and means defaults. Invalid JSON, schema versions, keys, values, non-file paths, or symbolic links are a warning and make /doctor the next action before any mutating workflow command. Report the effective regular and Continuous audit, independent-review, check, and try-guide policies, plus review.independentExecution. Explain that independent review defaults to when-sensitive for both workflows and execution defaults to automatic, which uses an isolated reviewer only when the current adapter supports it. Audit, check, and try guide default to manual. Before recommending /overview, check whether AGENTS.md still contains the shipped For a standard Next.js project command marker. When it does, onboarding is incomplete and /onboard is the next action.
  2. Build plan - blueprint/build-plan.md. Count checked vs unchecked leaf items. Name the next unchecked leaf, the same target /feature would pick, and note if a parent item was split into sub-items (4a, 4b, ...).
  3. Current work - blueprint/context/current-feature.md. Is something in progress, or is it the reset stub? If a feature, fix, or rollback spec is present, report its type and name, which build steps are checked, and the first unchecked step where /implement resumes.
  4. Findings - blueprint/context/findings.md. Count findings by status and report open and fixed counts next to build-plan progress. Call out any P0 or P1 still open or fixed by ID, since those block /complete. A missing file means no findings.
  5. Independent review - blueprint/context/review.md. Report none, pending, changes-requested, passed, malformed, or stale. For an active record, name the requested or actual reviewer adapter and model. A selected or explicitly initiated independent review blocks /complete until a passing receipt matches the exact current checkpoint and spec.
  6. Overview freshness - if blueprint/context/project-overview.md is missing or has no blueprint:source-hash, mention that /overview should run before new feature work. Otherwise use /overview's hash contract: exact project-plan bytes, one zero byte, then build-plan bytes with line-start - [x] and - [X] markers normalized to - [ ]. Treat a matching legacy exact-byte hash as current for backward compatibility. Recommend /overview only when the recorded hash matches neither value. Do not use filesystem timestamps; /complete legitimately makes build-plan.md newer when it checks off work.
  7. Git - current branch, whether the working tree is clean or has uncommitted changes, roughly how many files changed, last commit subject, and whether the branch is ahead of its remote. If the directory is not a git repo, say so and skip this part rather than failing.
  8. Progress drift - flag active spec on main, a spec in progress but no branch matching the configured feature, fix, or rollback prefix, all spec steps checked but not completed, or disagreement between build-plan.md and current-feature.md. With git.landing: "pull-request", an active feature may differ from the next unchecked item because parallel branches can be active. A rollback legitimately targets a checked build-plan item until /complete unchecks it, so do not compare it to the next unchecked feature.
  9. Dashboard activity - read blueprint/.state/run.json when it exists. Report the command, mode, status, progress, boundary, and safe resume command. A missing file simply means no activity has been recorded. Invalid activity state is a warning, not a blocker for the underlying workflow; point to /doctor to inspect and offer the approved generated-state reset.

Before choosing the next action, use the read-only candidate screen in the installed Complete skill (../complete/reference/completion-recovery.md). Inspect branch, working-tree changes, live state, relevant archives, and matching local work refs. Route a completion candidate to /complete for full phase proof; do not write Git objects or claim recovery has been verified from Status. On a clean local default branch with consistent live state and no matching work ref or pending completion evidence, the archive is settled history. Continue normal routing without requiring historical transient objects lost in a clone or prune. A reset stub alone does not establish this state. Actual candidates with missing or conflicting evidence need identification/repair before new work.

Show full SKILL.md (396 more words)Show less

Output

A short, scannable summary, not a wall of text. Aim for something like:

Status: Building feature 4 - PDF export
Config: Project settings.
Review execution: automatic.
Gates: regular audit manual, independent review when-sensitive, check when-behavioral, try guide manual;
       Continuous audit always, independent review manual, check always, try guide when-user-facing.
Plans: Overview current. Build plan 3 of 9 complete.
Current work: Step 2 of 3 done. Next step: Download PDF button.
Activity: /autopilot ready, 3/3 build steps, reviewed boundary.
Findings: 1 open P2 (F-04), 1 fixed P1 awaiting re-review (F-02).
Review: pending for Claude Code with the selected model.
Git: branch feature/pdf-export, 3 uncommitted files, last commit "feat: widen export helper".
Watch: F-02 is fixed but not re-reviewed; it blocks /complete until /audit closes it.

Next action: run /implement for Step 3.

End with a single suggested next action, chosen in this order:

  • The project configuration is invalid -> /doctor.
  • A completion candidate has conflicting or ambiguous evidence -> identify the exact missing archive, branch, or commit evidence before new work.
  • Pending completion candidate -> /complete to prove and resume its phase.
  • Dashboard activity is malformed -> /doctor.
  • The overview is missing or stale and no feature is in progress -> /overview.
  • A spec is in progress with unchecked steps -> /implement and name the step.
  • A spec is in progress and all implementation steps are checked -> /check if proof is not recorded, /check guide if the user wants a manual review path, /implement when a P0 or P1 finding is still open (the repair is an extra reviewed step), /audit when one is fixed and awaiting re-review (both block /complete), /audit independent current when independent review is required, pending, changes-requested, or stale, otherwise /complete.
  • current-feature.md is the reset stub and a P0 or P1 finding is open -> /fix <finding id>; when one is fixed, /audit to re-review and close it.
  • current-feature.md is the reset stub and unchecked build-plan items remain -> /feature and name the next build-plan item.
  • All build-plan items are checked -> say the current milestone is complete; suggest hardening, release, or docs when appropriate, or /feature "new capability" to propose an addition to the living build plan. Do not suggest creating a second build plan.

If something is off, include a Watch: line before the next action. Catching drift is half the value of the command.

Rules

  • Read-only, always. This skill never writes a file, never commits, never runs installs, never runs builds or tests, and never switches branches. If the user wants to act on what it reports, they run the relevant skill next.
  • Prefer exact next actions. Do not end with vague advice like "continue the workflow". Name the command and, when useful, the file or step.
  • Distill, don't dump. Report the state in a few lines. Do not paste file contents back unless the user asks for them.
  • Be honest about gaps. If a file is missing or the repo is not initialized, say that plainly instead of guessing.

Formatting

Format the output to match the project's conventions in blueprint/context/ai-interaction.md: concise, scannable markdown, with lists for enumerations and tables for matrices rather than dense paragraphs.

© aiblueprinthq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/status of aiblueprinthq/ai-blueprint.

Open the folder on GitHubat commit 96222b7

Compare with similar skills

Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Status this skillaiblueprinthq/ai-blueprint463—~2.4kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins11k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    11k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed

More from aiblueprinthq/ai-blueprint

All 20 skills in this repo
  • Adopt

    aiblueprinthq/ai-blueprint

    Adopt Blueprint into an existing brownfield codebase by surveying shipped behavior and generating plans, standards, commands, adapter choices, and visibility setup.

    463 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • CI

    aiblueprinthq/ai-blueprint

    Set up or normalize one project Verify command and matching GitHub Actions checks while preserving existing CI, with an optional local pre-push hook.

    463 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Doctor

    aiblueprinthq/ai-blueprint

    Run a Blueprint health and context check covering setup, adapters, commands, visibility, plans, overview freshness, configuration, dashboard state, and workflow drift.

    463 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check: notes
  • Feature

    aiblueprinthq/ai-blueprint

    Turn the next, named, or numbered build-plan feature into a buildable current-feature.md spec with small steps and done-when criteria.

    463 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Onboard

    aiblueprinthq/ai-blueprint

    Onboard a fresh or early scaffold after Blueprint is overlaid by tuning commands, standards, adapters, visibility, and context loading.

    463 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check passed
  • Overview

    aiblueprinthq/ai-blueprint

    Validate and normalize project-plan.md and build-plan.md, then generate the durable project-overview.md used by agents.

    463 GitHub stars~3.8k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Status

What does Status do?

Show read-only build-plan progress, active steps, git state, drift warnings, and the next action. Status is an agent skill from aiblueprinthq/ai-blueprint. Show read-only build-plan progress, active steps, git state, drift warnings, and the next action.

When should I use Status?

Status fits situations like: what is in progress; what comes next; resuming after a break.

How do I install Status in Claude Code?

Run `npx skills add aiblueprinthq/ai-blueprint --skill status -a claude-code`. Or copy the skill folder (.agents/skills/status in aiblueprinthq/ai-blueprint) into .claude/skills/status in your project. Claude Code loads it when a task matches its description.

How do I install Status in Codex?

Run `npx skills add aiblueprinthq/ai-blueprint --skill status -a codex`. Or copy the skill folder (.agents/skills/status in aiblueprinthq/ai-blueprint) into .agents/skills/status in your project. Codex loads it when a task matches its description.

Can I use Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiblueprinthq/ai-blueprint --skill status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/status, .gemini/skills/status, .github/skills/status and .opencode/skills/status in your project.

What does Status need to run?

SKILL.md names no scripts, command-line tools or credentials: Status is instructions for the agent only.

Does Status access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Status use?

Status is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Status use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Status?

Skills that share tags, products or a category with Status: Finishing a Development Branch (obra/superpowers, 297k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Code Design Rationale Investigator (cursor/plugins, 11k stars) and Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Status?

aiblueprinthq (a GitHub organization) maintains it in aiblueprinthq/ai-blueprint, which has 463 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 8, 2026.

Source: aiblueprinthq/ai-blueprint on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.