Meta

skill-state

by evil-within-rus

Implements a robust, flat-structured state management system for long-horizon AI agents, ensuring persistence, drift detection, and efficient context handling across restarts and context limits.

v1.0.0New

Signing

SignedSLSA L2
Signed by
skills-hub.ai distributor
Method
Distributor-signed by skills-hub.aiCryptographically signed by the skills-hub.ai distributor key at publish time.
Signed

Install this skill

Run this command in your terminal. No account required — it auto-detects your AI tool and installs the skill file.

npx @skills-hub-ai/cli install skill-state
Or download directly:
Browse all CLI commands →

Setup by platform

Claude Code

~/.claude/skills/<skill>/SKILL.md

Setup guide →

Cursor

~/.cursor/skills/<skill>/SKILL.md

Setup guide →

Install

One-click setup for your editor

Run in your project root

npx @skills-hub-ai/cli install skill-state --target claude-code
0

Examples

Prompt

Initialize the state management system for my project at /my/project with state.json in json format.

Output

The system checks for existing state.json at /my/project. If absent, it creates a new file with default keys like taskProgress, lastCheckpoint, contextSnapshot, and driftMetrics. It validates the content, ensuring a flat key-value structure, and prepares the state for agent operations, ready to persist updates after each task step.

Prompt

Detect drift between current context and stored snapshot, then reset state if drift is found.

Output

The system loads the stored contextSnapshot from state.json and compares it with the current context. If divergence exceeds threshold, it resets relevant state keys such as taskProgress and lastCheckpoint, updates contextSnapshot with the new context, and performs an atomic save to disk. It logs the drift detection and correction process, ensuring consistency for resumed operations.

Instructions

This skill doesn’t include stateful context yet, instructions only. Learn about stateful skills.

Security

Loading security scan...

Reviews (0)

View full changelog & diffs →

More Meta skills

Browse category →
skill-creatorCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.26 installsskillifyCreate a reusable, self-healing, self-evolving global skill — either from the current conversation context OR from a plain-language description of a workflow. Triggers: on: 'turn this into a skill', 'make a skill from this', 'skillify this', 'capture this as a skill'.9 installssave-tokensToken-efficient codebase navigation. Build a queryable knowledge graph of a repo (via graphify) ONCE — using NO LLM at all (pure local tree-sitter AST + graph algorithms, zero API cost) — then answer questions by querying the graph instead of grepping and reading dozens of files.8 installsload-contextLoad a saved conversation context to resume previous work. Supports local files, git repos, and URLs. Triggered by 'load context', 'resume previous work', 'pick up where I left off', 'load saved session', 'reload context'.4 installspublish-skillPublish a locally installed skill to the skills-hub registry and sync it to the production platform. Use when: 'publish skill X', 'push skill to hub', 'add skill to registry', 'publish to skills hub', 'share this skill', 'make skill available globally'. Runs entirely from the Mac Studio — no VPS needed.3 installssave-contextSave the current conversation context as a reloadable snapshot. Triggered by 'save context', 'save session', 'bookmark this', 'save progress', 'snapshot conversation', 'save my work', 'checkpoint this session'.3 installs

Frequently asked questions about skill-state

What does the skill-state skill do?

Implements a robust, flat-structured state management system for long-horizon AI agents, ensuring persistence, drift detection, and efficient context handling across restarts and context limits. It's a reusable SKILL.md instruction set that loads into your AI coding assistant on demand, no prompt engineering, no copy-pasting every session.

How do I install the skill-state skill?

Run `npx @skills-hub-ai/cli install skill-state` from your terminal. The CLI writes the SKILL.md to the correct location for your AI tool (e.g. ~/.claude/skills/skill-state/ for Claude Code or ~/.cursor/skills/ for Cursor with --target cursor) and adds it to your project's .skills.json lockfile.

Which AI tools does skill-state work with?

skill-state runs in Claude Code, Cursor. It follows the open Agent Skills standard (SKILL.md), so the same skill works in every supported tool without modification.

Is the skill-state skill free?

Yes. Every skill on skills-hub.ai is free and open-source. There are no premium tiers, paywalls, or usage limits. You only pay for whatever AI assistant you're already using.

How do I use skill-state after installing it?

In Claude Code, type `/skill-state` (or whatever slash command the skill registers) and the AI follows the skill's instructions immediately. You can also reference it by name in natural language, your AI loads the skill into context when relevant.

Can I share the skill-state skill with my team?

Yes. Commit your project's .skills.json lockfile and teammates run `npx @skills-hub-ai/cli install` (no args) to install every skill at the exact version you pinned. Organization-scoped installs work via skills-hub.ai organizations.