Agent skill

Next Action

by AlexZio00 in AlexZio00/sovereign-skills

A skill your agent uses when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact.

MITAuto-check passedDevelopment

Install Next Action

skills CLI
$ npx skills add AlexZio00/sovereign-skills --skill next-action -a claude-code

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

GitHub CLI
$ gh skill install AlexZio00/sovereign-skills next-action --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/AlexZio00/sovereign-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/next-action .claude/skills/next-action && 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
next-action
GitHub stars
140
Token cost
~1.4k tokens
SKILL.md length
627 words
Files
3
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact.

  • Works in 4 steps: Collect State (parallel, 30s cap) → Derive Candidates → Sort by Impact → …
  • The user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact
  • SKILL.md covers Dominant Variable, Purpose, Key Assumptions and Trigger, plus 7 more sections
  • Calls git

What it does

Next Action is an agent skill from AlexZio00/sovereign-skills. Use when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact. Trigger: '/next', 'what should I do next', 'next action'. Proposes only, never executes.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `.claude-plugin/plugin.json` and `agents/openai.yaml`).

It sits in Development. It works with Git. The repository describes itself as: 20 production-grade skills for AI coding agents — setup, scope, discipline, code review, security, session management, governance, ops, and quality audits (eval-leakage… The licence is MIT.

When your agent uses it

  • The user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact

Example prompts

  • “what should I do next”
  • “next action”
  • “/next-action”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Collect State (parallel, 30s cap)
  2. Derive Candidates
  3. Sort by Impact
  4. Output

What it can do on your machine

Read from SKILL.md and the folder at commit c062683. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Next Action loads about 1.4k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 627 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.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 AlexZio00/sovereign-skills at commit c062683, republished under its MIT licence (© AlexZio00). 627 words, ~1,430 tokens.

Download SKILL.mdSave it as .claude/skills/next-action/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
next-action
description
Use when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact. Trigger: '/next', 'what should I do next', 'next action'. Proposes only, never executes.
user-invocable
true
tools
Read, Bash, Glob
disallowed-tools
Edit, Write, NotebookEdit
not_for
Right after session start (session-start already outputs state), User already gave a specific task

/next — Next Action Recommender

Dominant Variable

Is the proposed action actually high-impact based on current project state? — it must come from measured files, not guesses.

Purpose

Reads current project state and proposes the top 3 next actions by impact. Different from stepback (direction check) — stepback asks "am I doing the right thing right now", this asks "what should I do next". Different from session-start (handoff load) — session-start restores the prior session, this recommends actions from current state.

Discard if: right after session start (session-start already loaded the handoff + output state). User already gave a specific task.

Key Assumptions

  1. Project has a CLAUDE.md — if broken: propose from git status alone (reduced scope).
  2. Is a git repository — if broken: propose from filesystem scan alone.

Trigger

  • /next
  • "what should I do next"
  • "next action"

Workflow

Step 1: Collect State (parallel, 30s cap)

Read the following 5 sources. Skip missing files.

  1. memory/session-handoff-LATEST.md — "What to do now" section
  2. git status --short — uncommitted changed files
  3. git log --oneline -5 — recent work flow
  4. tasks/lessons.md — conf≥0.7 lessons stale 30+ days (need re-application)
  5. docs/STATE.md or ~/.claude/STATE.md — PENDING blockers
Step 2: Derive Candidates

Extract action candidates from collected data. Check each candidate's own underlying source for freshness (the specific lesson's seen date, the specific commit referenced) — not just whether the handoff file as a whole is old:

  • Handoff "what to do now" → candidate as-is, but verify the specific file/commit it references is still current
  • Uncommitted files → "commit + push" or "needs verification"
  • PENDING blocker trigger satisfied → "resolve blocker"
  • Stale lesson → "re-apply/verify lesson"
  • git log pattern → "continue ongoing work" or "pivot direction"
Step 3: Sort by Impact

Narrow candidates to 3. Sort criteria:

  1. Urgency — resolve blocker > verify uncommitted > handoff item
  2. Dependency — prerequisites for other work take priority
  3. Timeliness — time-sensitive items (data collection after market close, pre-deploy verification, etc.)
Step 4: Output
## Next Actions

1. **[action]** — [1-line rationale. State which source it came from]
2. **[action]** — [rationale]
3. **[action]** — [rationale]

Tell me the number and I'll start that work in the next message.

Output then stop immediately — this skill's own execution ends here (Invariant 1). If the user picks a number, the main session starts that work on the next turn; this skill does not continue and execute it itself.


Scope Boundary

DoesDoes NOT
[READ] Read handoff/git/lessons/STATEExecute the proposed action directly
[READ] Propose top-3 actions by impactModify code or create files
[READ] State the evidence source for each proposalStart work without user confirmation
Show full SKILL.md (244 more words)Show less

Invariants (never violate)

  1. Proposal only, never execute: recommend an action but never start it directly. Only proceed once the user picks. Violation → work executed without user intent.
  2. Evidence-based proposals: derive candidates only from git status/Glob/Read results. Never guess "this is probably needed". Violation → phantom proposals for nonexistent files/issues.
  3. 3-item cap: even with 10 candidates, narrow to 3. Prevents choice overload. Violation → user can't choose and defaults to "just handle it yourself".
  4. 10-line cap: output exceeding 10 lines is over-explaining. Violation → no longer distinguishable from stepback.

Error Recovery

Failure TypeRecovery
tool_failureSkip the source that failed to read, propose from the rest (note: partial_read)
missing_dataIf both handoff and STATE are absent, propose from git status alone (note: minimal_mode)

Rationalization Table

RationalizationRebuttal
"5 recommendations would be more useful"Beyond 3 is choice overload. 3 is the optimal number for action conversion (note: cap_violation)
"Just executing right away is faster"Violates Invariant 1. Proposal and execution are different skills' jobs (note: scope_creep)
"Handoff alone is enough, why check git too?"Handoff is a past snapshot. Current git status is the real state (note: stale_source)

Truthful Reporting

  1. no mock deception: never conclude "nothing to do" without actually reading files.
  2. no silent brokenness: if a source fails to read, state ⚠️ failed to read [source name] explicitly.

Principles

  • Current state is truth — the filesystem is authoritative, not memory
  • Proposal is light, execution is heavy — this skill stays on the light side

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

Files

SKILL.md and 2 other files in next-action of AlexZio00/sovereign-skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • agents/openai.yaml

Open the folder on GitHubat commit c062683

Compare with similar skills

Next Action 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.

Next Action compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Next Action this skillAlexZio00/sovereign-skills140—~1.4kAutomated safety check: PassMIT
Commit Context Lookuprohitg00/agentmemory29k—~522Automated safety check: PassApache-2.0
Review Triage Phaseprisma/orm48k—~995Automated safety check: PassApache-2.0
Build Px4 macOSPX4/PX4-Autopilot13k—~1.1kAutomated safety check: PassBSD-3-Clause
Leon Coding Agentleon-ai/leon18k—~1.1kAutomated safety check: PassMIT
Git Worktree IsolationjnMetaCode/superpowers-zh8.3k1 repos~982Automated safety check: PassMIT

Similar skills

  • Commit Context Lookup

    rohitg00/agentmemory

    Traces a file, function or line back to the agent session behind its current commit, using git blame and a memory lookup, and reports only what the records show.

    29k GitHub stars~522 tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.

    48k GitHub stars~995 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Build Px4 macOS

    PX4/PX4-Autopilot

    Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.

    13k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Leon Coding Agent

    leon-ai/leon

    Has Leon's agent investigate, change and verify code in a repository with its file, search and shell tools, staying inside the scope the owner authorized.

    18k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    DevelopmentAuto-check passed
  • Worktree

    AgentsMesh/AgentsMesh

    Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.

    2.4k GitHub stars~553 tokensUpdated 17 days ago
    DevelopmentAuto-check: notes

More from AlexZio00/sovereign-skills

All 17 skills in this repo
  • Project Overview

    AlexZio00/sovereign-skills

    A skill your agent uses when the user wants a deterministic cross-project status map generated from registered projects' session handoffs.

    140 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Scope

    AlexZio00/sovereign-skills

    Scope definition before implementation — two modes. An agent skill from AlexZio00/sovereign-skills.

    140 GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Project Init

    AlexZio00/sovereign-skills

    Interview-based project setup — generates CLAUDE.md, ROADMAP, .gitignore, .env.example from scratch.

    140 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check: notes
  • Collab Audit

    AlexZio00/sovereign-skills

    This skill should be used when the user types /collab-audit or requests AI collaboration diagnosis.

    140 GitHub stars~8k tokensUpdated yesterday
    Auto-check passed
  • Doc Drift

    AlexZio00/sovereign-skills

    A skill your agent uses when the user wants to audit the memory and documents Claude Code loads into context — CLAUDE.md (user global + project + nested), MEMORY.md, @imports, .claude/skills…

    140 GitHub stars~6.2k tokensUpdated yesterday
    Auto-check passed
  • Session Checkpoint

    AlexZio00/sovereign-skills

    A skill your agent uses when saving session state before context compaction, switching tasks, or ending a session.

    140 GitHub stars~14k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Next Action

What does Next Action do?

A skill your agent uses when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact. Next Action is an agent skill from AlexZio00/sovereign-skills. Use when the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact.

When should I use Next Action?

Next Action fits situations like: the user wants a next-action recommendation based on current state — reads handoff/git/lessons/STATE and proposes top-3 by impact.

How do I install Next Action in Claude Code?

Run `npx skills add AlexZio00/sovereign-skills --skill next-action -a claude-code`. Or copy the skill folder (next-action in AlexZio00/sovereign-skills) into .claude/skills/next-action in your project. Claude Code loads it when a task matches its description.

How do I install Next Action in Codex?

Run `npx skills add AlexZio00/sovereign-skills --skill next-action -a codex`. Or copy the skill folder (next-action in AlexZio00/sovereign-skills) into .agents/skills/next-action in your project. Codex loads it when a task matches its description.

Can I use Next Action 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 AlexZio00/sovereign-skills --skill next-action -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/next-action, .gemini/skills/next-action, .github/skills/next-action and .opencode/skills/next-action in your project.

What does Next Action need to run?

Going by SKILL.md and its folder, Next Action needs the command-line tools its instructions call (git).

Does Next Action access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Next Action 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 Next Action use?

Next Action 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 Next Action use?

About 1.4k tokens (SKILL.md is roughly 5.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 Next Action?

Skills that share tags, products or a category with Next Action: Commit Context Lookup (rohitg00/agentmemory, 29k stars), Review Triage Phase (prisma/orm, 48k stars), Build Px4 macOS (PX4/PX4-Autopilot, 13k stars) and Leon Coding Agent (leon-ai/leon, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Next Action?

AlexZio00 (a GitHub user) maintains it in AlexZio00/sovereign-skills, which has 140 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

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