agentleFS
aantoniadisaantoniadis/skills/skills/whats-next/SKILL.md

whats-next

Skill0 starsChanged 33 days agoMITView on GitHub

Tells the user which skill to run next in the change workflow and how: the step, the command for this host, and whether to stay in this session or start a new one. Use when the user asks what to run next, where they are in the flow, which skill fits the work in front of them, or how to continue after a step finished. Not for doing the step itself (the named skill), preparing tools (setup-tools), or routing among Matt Pocock's skills alone (his ask-matt).

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use release and handoff.

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.
  • MicrosoftSkill

    release

    Use ONLY when the user explicitly asks to cut/publish a Huabu desktop release or tag a version. Performs an outward action — bumps the version in apps/desktop/package.json, commits + annotated-tags vX.Y.Z, and pushes the branch + tag. That tag push auto-builds the macOS/Windows installers and publishes a GitHub Release. Provides `status`, `bump`, `tag-push`, and a one-command `run` (bump → tag-push).

    Also in 3 projects that use this

  • MicrosoftSkill

    handoff

    Compact the current conversation into a handoff document for another agent to pick up.

    Also in 3 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 13 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:

    Add what the scan cannot see: the step this conversation just finished and the path or URL it reported, the decisions the user stated, and …

    line 28
  2. Very specific:

    Write the command as the host registers it: /aantoniadis-skills:<name> in Claude Code, $aantoniadis-skills:<name> in Codex, /<name> or …

    line 77

“Common” is measured: kept by at least 6 in 10 of the 13 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

For helper loading, follow package references. Write in the shared technical English; name the evidence behind the placement, as evidence says.

What's next

Give one answer: where the user is in the workflow, the next step, the exact command, and the session to run it in. Read the state first; ask only when two positions fit. Write nothing to the project, and stop after the answer: the user runs the next step.

1. Read the state

Run python3 <package>/skills/whats-next/scripts/workflow_state.py <project>. It prints the branch and its distance from the default branch, the uncommitted files, the investigation location, every note and report our skills left (understanding note, plan, diagnosis note, PR review guide, acceptance report) with its summary line and date, local tickets, visual-pr tasks, Matt's tracker setup, and whether a local tool record exists. It reads only and creates nothing.

Add what the scan cannot see: the step this conversation just finished and the path or URL it reported, the decisions the user stated, and the argument when it names a goal. When the branch has an upstream, check for an open PR with the host's Git tooling, such as gh pr view. Print the tool record with python3 <package>/skills/tool_setup_path.py --show <project> to learn which originals are installed and how the host registers them; none means no setup ran, so take install commands from original skills.

2. Place the user

Take the first row whose evidence holds, top to bottom. "The same session" is the one that holds the planning conversation. "A new session" is a fresh context window: a new session in the host, or its clear command.

EvidenceNextSession
A failing check, an issue reporting wrong behavior, or a production symptom, with no diagnosis note for itfix-bug, with the symptom and the contract when knownWhere the symptom arrives: the implementing session for a check it broke, a new one for an issue or a production symptom
A PR the user did not write and has to reviewpr-review-guide, with the PR URLA new session, without the author's context
An epic, tickets, or a spec, and a delivered head or an integration branchcheck-acceptance, with the sources and the headA new session on the delivered head
An acceptance report with Partial or Unmet rows, or bug cardsplan-change for a missing decision, Matt's implement per gap, fix-bug per bug card, each with the report pathA new session per handoff
A feature branch ahead of the default branch, and no PRfind-bugs on the branch against the default branch, then HumanLayer's visual-prThe implementing session, or a new one checked out on the branch
Tickets with blocking edges, and no commits for them yetMatt's implement per unblocked ticket, or implement-spec for the whole specA new session per ticket, on the feature branch; one new session for implement-spec
A plan whose Readiness line says ready, and no spec or ticketsplan-change to draft the spec and tickets, or Matt's to-spec then to-ticketsThe same planning session, unbroken
A plan with open decisions or blocked slicesplan-change on the open choicesThe same planning session
An understanding note, and no planplan-change, with the note pathThe same session
A change with consequences beyond its own function, and no note or planexplain for one concrete question about today's behavior, or plan-change when the flow is already knownStart the planning session here
A contained change in familiar codeNo skill: the host's normal coding workflow, with find-bugs when a defect search would helpThe current session
Investigation work ahead, and no local tool recordsetup-tools, naming the skills to runAny

An idea with no repository under it takes Matt's grill-me. A huge, foggy effort takes his wayfinder, which merges at to-spec. When two rows fit and the conversation does not settle it, ask one question with the recommended row first, as asking says for a round and for a host without the question tool.

3. Answer

Reply in this shape, with the real paths and URLs from the scan:

**Where you are:** <position, with its evidence: branch, file, PR, report line>
**Next:** <skill> — <what it settles, one line>
**Run:** <the command for this host, with the paths and the choices already settled>
**Session:** <same | new> — <reason>
**Carry:** <the paths or URLs the next step needs, which a fresh session cannot see>
**Also possible:** <one alternative row, and when it is the better one>

Write the command as the host registers it: /aantoniadis-skills:<name> in Claude Code, $aantoniadis-skills:<name> in Codex, /<name> or opencode run --command <name> in OpenCode; an original as the tool record lists it, such as /mattpocock-skills:implement or /implement. Put a kickoff choice the conversation already settled inside the command, so the next skill asks less. When an original is not installed, give its install command and the local route instead. Name what was not checked, such as a tracker that could not be reached. Done when the user can paste the command.

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.