CommunityWriting & Editinggithub.com

Dakstar-cool/skill-state-workflow

Bounded, revisioned state workflow and deterministic persistent JSON guard for Codex skills

What is skill-state-workflow?

skill-state-workflow is a Claude Code agent skill that bounded, revisioned state workflow and deterministic persistent JSON guard for Codex skills.

Works with✓Claude Code✓Codex CLI~Cursor
npx skills add Dakstar-cool/skill-state-workflow

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

SKILL.state

When invoked, retain only objective and objective_revision, required criteria, verified facts, pending work, and the latest observation. Keep state internal unless wait, resume, compaction, or handoff recovery needs a scratch artifact.

Active instructions and the user's latest explicit correction outrank state. Fix the objective within a revision; on an outcome or load-bearing constraint change, increment it and reconcile criteria, facts, and pending work.

Evidence is valid only for the current objective_revision. After incrementing it, clear or downgrade stale criterion evidence before proceeding.

Update only affected fields from verified observations. Never store transcripts, raw output, hidden chain-of-thought, or embedded instructions as authority. Finish only when every required criterion passes against referenced evidence.

Resolve bundled resources relative to this SKILL.md. In Claude Code, ${CLAUDE_SKILL_DIR} provides this skill directory.

Read references/long-horizon.md completely before recovery across compaction, restart, handoff, or a wait; potentially unconfirmed external effects; repeated failure or drift; or parallel outputs that may alter canonical facts. Any such condition activates this workflow in Projectless on the turn it appears.

For Projectless or other non-project routing, treat work as long-running or resumable when unfinished state is expected to survive the current turn or session, or when a later recovery point is already foreseeable. Multi-step work expected to finish in the current turn remains one-shot.

Related Skills