state-ops

state-ops is a skill for Claude Code from fakoli/fakoli-plugins. It costs 63 tokens per session (3,339 once invoked), scanned A, original, MIT.

A read-only inspection workflow for viewing fakoli-state project information, including tasks, dependencies, active claims, blockers, conflict warnings, and filesystem differences. It reports what the system knows without changing it.

In plain words
What is it for?
It helps check project status, find claimable tasks, trace blockers, review conflicts, and compare recorded state with files and Git.
Why use it?
It gives developers a current view of project progress and coordination risks before they start or resume work.

Skill for Claude Code

Written for Claude Code: SessionStart hook event.

Part of the fakoli-state plugin — 5 skills, 4 agents, 1 MCP server shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fakoli/fakoli-plugins/state-ops
Any agent
npx skills add fakoli/fakoli-plugins --skill state-ops
Clone the repo
git clone --depth 1 https://github.com/fakoli/fakoli-plugins

Made for: Claude Code.

Or install fakoli-state, the plugin that ships this one along with the rest of its 5 skills, 4 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for state-ops

README.md
[![agentmods](https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/state-ops.svg)](https://agentmods.dev/skills/fakoli/fakoli-plugins/state-ops)
Your own site
<a href="https://agentmods.dev/skills/fakoli/fakoli-plugins/state-ops"><img src="https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/state-ops.svg" alt="Measured on agentmods" height="20"></a>
Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,339 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00063 $0.03339
Opus 5 $0.00032 $0.01670
Sonnet 5 $0.00013 $0.00668
Haiku 4.5 $0.00006 $0.00334

Measured 2d ago against content hash fe79928eeaf7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

state-ops scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/fakoli-state/skills/state-ops/SKILL.md · 328 lines

How it starts

The opening of the file, as written. The whole thing — 328 lines — stays where its author put it; the contents beside it link to each section on GitHub.

State-Ops — State Inspection

Read the canonical SQLite state that fakoli-state maintains: project summary, task inventory, claim activity, dependency graph, conflict warnings, and filesystem reconciliation. This skill makes no mutations.


When to Use

  • When orienting before starting a work session — run status first, always.
  • Before claiming a task — confirm the PRD is approved and the task is ready.
  • When a claim was interrupted and the state of the queue is unclear.
  • When multiple agents are active and conflict risk is non-trivial.
  • When a task shows as blocked and the blocker chain needs tracing.
  • When suspicious that orphan branches or stale packets exist on disk.
  • When reporting project progress to a human or another skill.

State-ops is NOT for authoring or reviewing PRDs — use the prd skill. State-ops is NOT for generating plans or scoring tasks — use the plan skill. State-ops is NOT for claiming work or submitting evidence — use the claim and execute skills. This skill only reads.


Prerequisites

The project must have run fakoli-state init at least once. Check for the sentinel file:

ls .fakoli-state/state.db 2>/dev/null || echo "MISSING: run fakoli-state init first"

If .fakoli-state/state.db does not exist, refuse to proceed and tell the caller to run:

fakoli-state init --name "<project-name>"

Do not attempt to read state, list tasks, or call any other fakoli-state command until state.db is confirmed present.


Workflow

Step 1 — Get the project summary

Phase 2 — available now.

fakoli-state status

Returns: PRD status (draft / reviewed / approved), total task count, per-status breakdown (proposed, drafted, reviewed, ready, claimed, in_progress, done), active claim count, blocker count, and sync state.

Run this first. The output orients every subsequent decision — it answers whether work is even possible before touching any other command.

Read the full file on GitHub · 328 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 328 lines · 63 tokens per session scan A fe79928eeaf7

Subscribe to this mod's changes

state-ops is a skill published in the GitHub repository fakoli/fakoli-plugins (4 stars, last pushed 28d ago), licensed MIT. It adds 63 tokens to every session and 3,339 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

better-auth-knowledge-patch

Use this skill when implementing, upgrading, debugging, or reviewing Better Auth applications. Start with the quick references below, then load the topic file that matches the task.

Nevaberry/nevaberry-plugins · 9 tokens

clickhouse-knowledge-patch

Use this skill when writing, reviewing, upgrading, or operating ClickHouse SQL and server configurations. Start with the compatibility-sensitive items below, then load the topic reference that matches the task.

Nevaberry/nevaberry-plugins · 9 tokens

arch-knowledge-patch

Restart the daemon immediately after upgrading openssh to 9.8p1 because the old daemon cannot accept new connections.

Nevaberry/nevaberry-plugins · 8 tokens

axum-knowledge-patch

Axum 0.8 uses return-position impl Trait in FromRequestParts and FromRequest. Implement their methods with native async fn; do not retain the old #[asynctrait] annotation.

Nevaberry/nevaberry-plugins · 9 tokens

caddy-knowledge-patch

Use this patch when writing or reviewing Caddyfile or JSON configuration, upgrading Caddy, building custom binaries, or operating Caddy's HTTP, proxy, certificate, and telemetry features.

Nevaberry/nevaberry-plugins · 9 tokens

cloudflare-d1-knowledge-patch

Use this skill when designing, implementing, migrating, operating, or debugging Cloudflare D1 databases. Check the project’s Wrangler configuration, binding usage, database generation, account plan, and remote-versus-local command flags before applying guidance.

Nevaberry/nevaberry-plugins · 13 tokens