agentleFS
raisoninmeraisoninme/boardless-pcb/skills/status/SKILL.md

status

Skill2 starsChanged 3 months agoMITView on GitHub

Show flow status: current step, open issues, and the next command to run

177 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use off, list and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • StakeholderSenseiSkill

    off

    Disable polygraph for this repo (user-only escape hatch; all hooks no-op)

    Also in 4 projects that use this

  • SuShuhengSkill

    list

    Use when checking obshare-cli upload history, finding document tokens, or reviewing previous upload URLs and permission snapshots.

    Also in 8 projects that use this

  • kennethleungtySkill

    pause

    Pause — stop the music (alias for /stop)

    Also in 6 projects that use this

  • codebycoreySkill

    new

    Start a new change with a proposal. Use when starting a feature, creating a proposal, or beginning planned work.

    Also in 7 projects that use this

  • michaelenglandSkill

    import

    This skill should be used when the user wants to import an existing .pptx file into deckwright, bring in a PowerPoint that was created outside this tool, reverse-engineer a presentation for editing, or invoke /deckwright:import. Converts a .pptx into a PptxGenJS generation script so it can be edited and regenerated through the deckwright pipeline.

    Also in 5 projects that use this

  • genomewalkerSkill

    resume

    Resume a thread by loading its ~800-token context capsule

    Also in 15 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 146 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read-only command; performs no step work.

    line 8
  2. Very specific:

    If the user then asks to execute a step, remind them: steps run in a fresh session (= /clear or restart your agent in this project) via …

    line 17

“Common” is measured: kept by at least 6 in 10 of the 146 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Flow status

Read-only command; performs no step work; runnable in any session. Respond in the user's language.

  1. Read docs/flow-state.md. Missing → tell the user this project hasn't entered the flow; the entry point is step1-onboard (Claude Code: /boardless-pcb:step1-onboard) (in a fresh session). Present but without the canonical header line flow-state — process state → it belongs to something else; treat the project as not-in-flow and say so.
  2. Spot-check consistency: for every step marked done, confirm that the deliverables which look like file paths actually exist (non-file deliverables — sign-offs, tool lists, inspection records — are not checked and not drift). Call out real gaps (a done status whose files are missing = state drift; suggest the user correct the status or restore the deliverables).
  3. Report (one short paragraph + one small table, no deep dives):
    • Current step and each step's status. Token semantics matter here: in-progress = running or aborted mid-flight (say which is likelier); waiting = blocked on other steps, resumes automatically once they clear — not an abort; parked = the flow is deliberately stopped by a user decision and the board is NOT fab-ready — say this plainly and name the parking decision (the deferred issue holds it); rework = needs redoing
    • Open issues: how many, each one's target, severity, and status
    • Verification rounds: report any pending-verdict row in the whole table (not just the last one) — each is an aborted or unreconciled verification session
    • Next action — normalize everything actionable to a target step and recommend the earliest: steps marked rework and issues open with target 2–5 both map to their step number (multiple items on one step merge into a single recommendation — fixing the earliest step first avoids re-reworking later ones); issues fixed-pending-verify and open with target step6 map to step 6, which participates only when no earlier step is actionable; a parked step is NOT a recommendation — state that resuming it is the user's call (re-run its command to un-park); nothing actionable → the EARLIEST step not marked done — unless that step is parked, in which case make NO recommendation: say plainly that the flow is stopped where the user chose to stop it, and that re-running that step's command un-parks it (never skip past a parked step to a later one — the later step's own gate would reject it anyway); every step done → the flow is complete
  4. If the user then asks to execute a step, remind them: steps run in a fresh session (= /clear or restart your agent in this project) via their command; if this session has already done other work, don't run a step here.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.