Download plugins/ai-agency/hyperflow/skills/status/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does status live?
The publisher keeps it at https://github.com/jeremylongshore/tons-of-skills-marketplace.
Which agents can use status?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.
|
name: status
description: |
Use when the user wants a one-screen view of current hyperflow project state — version, profile freshness, memory count, and live progress on every in-flight task. Read-only; never modifies state, never dispatches workers.
Trigger with /hyperflow:status, "what is hyperflow doing", "show task progress", "where are we".
allowed-tools: Read, Bash(git:), Bash(ls:), Bash(stat:), Bash(date:), Bash(grep:), Bash(sed:), Bash(cut:), Bash(head:), Bash(awk:*), Glob, Grep
argument-hint: ""
version: 3.1.3
license: MIT
compatibility: Designed for Claude Code
tags: [introspection, read-only, project-state]
Status
Read-only snapshot of the current hyperflow project, with live progress on every active task file. Standalone — does not auto-chain and is never invoked by other skills. Invoked manually via /hyperflow:status.
In-flight work — per-task live progress (sub-tasks done/total, tokens, wall-clock, ETA)
What to read
Static snapshot
Field
Source
Fallback
Version
Latest git tag matching v* + tag commit date
(missing)
Profile
.hyperflow/profile.md file modification time
(missing)
Memory
Line count of .hyperflow/memory/index.md minus header rows
(none)
Active tasks
Files matching .hyperflow/tasks/*.md
(none)
Active features
Folders matching .hyperflow/features/*/feature.md
(none)
Active features (multi-phase work)
For every .hyperflow/features/*/feature.md (see feature-phases.md), parse its
## Status block and the phase roster, then for each phase-<n>-*/phase.md show the phase status + Progress bar:
The per-phase bar uses the same parsing as the per-task-file section below (each phase.md carries the same
## Status block shape). Omit this section when no .hyperflow/features/*/ exist.
In-flight work (per task file)
For every .hyperflow/tasks/*.md, parse its ## Status block (written by /hyperflow:plan at creation and updated by /hyperflow:dispatch after each sub-task PASS — see plan/SKILL.md Step 10):
Field
Source
Behaviour
Slug
basename of the task file minus .md
always present
Done / total
Sub-tasks: <done> / <total> from Status block
falls back to counting [x] vs [x]+[ ] checkboxes if Status missing
Done sub-task names
lines with [x] from the ## Batches section
listed under the bar
Running sub-task
the first [~] checkbox (dispatch marks ~ while a sub-task is mid-flight)
grep '^- \[x\]' "$file" | sed -E 's|^- \[x\] *||' | head -5
Show up to the last 3 completed + the currently running sub-task. If there are more than 3 done, prefix the list with … (N earlier done).
Running sub-task
The dispatch skill marks the in-flight sub-task with [~] while the worker is running. After PASS + commit, dispatch flips [~] → [x].
running=$(grep '^- \[~\]' "$file" | sed -E 's|^- \[~\] *||' | head -1)
If no [~] line exists → the dispatch is either between sub-tasks (idle for milliseconds) or has handed control back. Show (idle — last update Xm Ys ago) based on Last update: timestamp.
Progress bar
20-char ASCII bar based on done / total:
[████████████░░░░░░░░] 12/20 60%
Use █ (filled) and ░ (empty). No emoji or color icons.
Output format
Print the block below verbatim. If no in-flight tasks, omit the ── In-flight work ── section.
── Hyperflow Status ─────────────────────────────────────────
Version v3.0.0 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks 2
── In-flight work ───────────────────────────────────────────
Task: implement-auth
Progress [███████████░░░░░░░░░] 8/14 57%
Last done T7: Reset email worker
Running T8: Login UI (Implementer · 14s elapsed)
Pending 6 sub-tasks
Tokens thinking 89.2k · worker 142.0k · total 231.2k
Wall-clock 4m 22s elapsed
ETA ~3m 16s remaining (avg 32s/sub-task · 6 left)
Task: fix-login-bug
Progress [░░░░░░░░░░░░░░░░░░░░] 0/3 0%
Status not started (created 8m ago, no dispatch run yet)
─────────────────────────────────────────────────────────────
When Profile is (missing), omit the (analyzed Xh ago) parenthetical.
When Version is (missing), print Version (missing).
When no .hyperflow/tasks/*.md files exist, omit the ── In-flight work ── section entirely; the snapshot block stands alone.
Format as Xm Ys or Hh Mm (skip zero leading units). Show (computing) when done < 3 — too few data points for a useful average.
If the task has multiple batches and the next batch is sequential per the planner output, multiply remaining by 1.1 to account for inter-batch synchronisation overhead.
No .hyperflow/tasks/*.md files → Active tasks (none), no In-flight section
Task file present but Status block malformed/missing → fall back to checkbox count, show (not tracked yet) for tokens/ETA
Started: line absent → Status not started, skip ETA
Never error out. Never modify any file. Never dispatch an agent.
Doctrine
This skill has no Worker/Reviewer dispatch — it is a pure read. It does not count as a hyperflow run and does not append to memory. Output style follows output-style.md — no decorative icons, em-dash separators, plain status words.
Overview
/hyperflow:status prints a one-screen snapshot of the project's hyperflow state plus a live progress block for every in-flight task. Useful when picking up a session mid-flight, deciding whether to invoke /hyperflow:dispatch, or auditing whether a chain run is still healthy. Pure read — no agents, no writes, no chain side-effects.
Prerequisites
Git repository (for the version line — degrades to (missing) otherwise).
.hyperflow/ directory (for profile/memory/tasks lines — each section degrades to (missing) or (none) if absent).
No prerequisites for invocation itself — runs anywhere.
Stat .hyperflow/profile.md for freshness; bucket into fresh/stale/missing.
Count entries in .hyperflow/memory/index.md.
Glob .hyperflow/tasks/*.md and parse each Status block for live progress.
Render the static snapshot block; render the In-flight block per task (if any).
Stop. No prompts, no follow-ups.
Output
See Output format above for the exact block. Two sections — static snapshot and (if there are active tasks) In-flight work with per-task progress bar, last-done sub-task, currently-running sub-task, pending count, tokens, wall-clock, ETA.
Error Handling
Failure
Behavior
Not a git repo
Version (missing); everything else still renders if .hyperflow/ exists.
.hyperflow/profile.md missing
Profile (missing) (no parenthetical).
.hyperflow/memory/index.md missing
Memory (none).
No task files
Omit the In-flight section entirely; just print the snapshot.
Task file with malformed Status block
Fall back to counting [x] vs [ ] checkboxes; show (not tracked yet) for tokens/ETA.
stat flag differs between BSD (macOS) and GNU (Linux)
Try stat -f %m then fall back to stat -c %Y.
Never errors out. Never modifies any file. Never dispatches an agent.
Examples
Healthy project, no active tasks
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks (none)
─────────────────────────────────────────────────────────────
Mid-dispatch with two active tasks
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile fresh (analyzed 2h ago)
Memory 12 entries
Active tasks 2
── In-flight work ───────────────────────────────────────────
Task: implement-auth
Progress [███████████░░░░░░░░░] 8/14 57%
Last done T7: Reset email worker
Running T8: Login UI (Implementer · 14s elapsed)
Pending 6 sub-tasks
Tokens thinking 89.2k · worker 142.0k · total 231.2k
Wall-clock 4m 22s elapsed
ETA ~3m 16s remaining (avg 32s/sub-task · 6 left)
Task: fix-login-bug
Progress [░░░░░░░░░░░░░░░░░░░░] 0/3 0%
Status not started (created 8m ago, no dispatch run yet)
─────────────────────────────────────────────────────────────
Brand new install (no .hyperflow/ yet)
── Hyperflow Status ─────────────────────────────────────────
Version v3.1.2 (released 2026-05-16)
Profile (missing)
Memory (none)
Active tasks (none)
─────────────────────────────────────────────────────────────
Resources
output-style.md — em-dash style, no decorative chars, plain status words.
DOCTRINE.md — orchestration rules (status is exempt from per-step agent dispatch).
How do I install status?
Download plugins/ai-agency/hyperflow/skills/status/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does status live?
The publisher keeps it at https://github.com/jeremylongshore/tons-of-skills-marketplace.
Which agents can use status?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.