stateUpdate

Append conversation progress, learnings, and decisions to timestamped .state files.

1|Updated Aug 6, 2022

Search Tags:#decisions #learnings #open-questions #conversation-context #state-update #state-file

Ready to run

npx skills add https://github.com/wormholecowboy/.dotfiles --skill stateupdate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: stateUpdate
Source: https://github.com/wormholecowboy/.dotfiles/tree/main/claude-config/skills/state-manager/stateUpdate
Command: npx skills add https://github.com/wormholecowboy/.dotfiles --skill stateupdate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The State Update skill helps you persist essential context across long conversations by updating the active state file with new learnings, decisions, and context. It ensures critical information is captured before context resets and makes it available for future reference.

Core Features & Use Cases

Incremental state updates: append latest progress to the active state file, preserving a running history.
Structured guidance: automatically capture learnings, decisions, open questions, and next steps in clearly labeled sections.
Use Case: during a multi-hour project or coaching session, run stateUpdate periodically to retain decisions and context (e.g., .state/{timestamp}.state.md) for continuity.

Quick Start

Use the stateUpdate skill to append the latest conversation progress to the active state file (e.g., .state/2026-02-06.state.md).

Frequently Asked Questions about stateUpdate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I persist conversation context across long sessions before it resets?▼

To persist conversation context across long sessions, use a state update workflow that periodically writes progress, decisions, and learnings into timestamped .state files, ensuring critical information is retained before context resets.

What is the best way to track decisions and open questions during multi-hour projects?▼

The best way to track decisions and open questions during multi-hour projects is by appending incremental updates to a structured state file, which automatically organizes context, learnings, and next steps into clearly labeled sections.

How do I create a timestamped state file for conversation progress?▼

You create a timestamped state file for conversation progress by running a state update process that enforces deterministic writes to files like .state/{timestamp}.state.md, updating frontmatter and organizing content into structured sections.

Can I append new learnings to an existing state file without losing history?▼

Yes, you can append new learnings to an existing state file without losing history by using incremental state updates, which preserve a running history while adding the latest progress, decisions, and context to the active file.

Does capturing evolving context require manually formatting the state file sections?▼

No, capturing evolving context does not require manually formatting sections because the state update workflow automatically organizes entries into predefined sections for context, decisions, learnings, open questions, and next steps.

When should I run a state file update during a long coaching or project session?▼

You should run a state file update periodically during long coaching or project sessions whenever new decisions are made or context evolves, ensuring that essential information is captured before any potential context window reset.