skills.rest
wormholecowboy
wormholecowboyCOMMUNITY
Explore all skills by this author →
GitHub

stateCreate

Create timestamped session state files in a .state directory.

1|Updated Aug 6, 2022
Search Tags:#state management#repository#shell#session persistence#timestamped file#gitignore automation
One-click install
npx skills add https://github.com/wormholecowboy/.dotfiles --skill statecreate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stateCreate
Source: https://github.com/wormholecowboy/.dotfiles/tree/main/claude-config/skills/state-manager/stateCreate
Command: npx skills add https://github.com/wormholecowboy/.dotfiles --skill statecreate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill creates a dedicated .state/ directory and timestamped state files to persist session context across context resets. It simplifies starting new working sessions without losing continuity, by storing essential metadata and a ready-to-use template.

Core Features & Use Cases

  • Create .state/ directory if missing
  • Add .state/ to .gitignore if not present
  • Generate filename using Unix timestamp: $(date +%s).state.md
  • Create state file with a consistent template
  • Confirm creation to user
  • Use Case: Begin a new session and preserve context across resets for long-running conversations or projects

Quick Start

Use the stateCreate skill to generate a new session state file in the repository root, named with the current Unix timestamp, e.g. .state/1700000000.state.md.

Frequently Asked Questions about stateCreate

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

FAQPage Schema
How do I persist session state across context resets in a repository?▼

Session state persistence saves working context by writing metadata like session_id and timestamps into a structured Markdown file within a .state directory, allowing new sessions to recover previous context after resets.

How do I automatically add a state directory to gitignore?▼

Automating gitignore updates ensures the .state directory used for session persistence is excluded from version control. The skill checks for and appends the .state path to .gitignore during the state file creation process.

What is the best way to generate timestamped session files for long-running projects?▼

Generating timestamped session files involves using the current Unix timestamp to name the Markdown file, such as 1700000000.state.md. This ensures unique state tracking for each new working session in long-running projects.

Does this session persistence approach work without external dependencies?▼

Yes, this session persistence approach works without external dependencies. It relies solely on creating a local .state directory and generating a Markdown template file to store session metadata within your existing repository.

Why use a Unix timestamp for naming repository state files?▼

Using a Unix timestamp for naming repository state files prevents naming collisions and maintains chronological order. It clearly identifies when each session state was created for easier tracking and recovery.

Related Skills

Explore More Software Engineering Skills→
smarmen86smarmen86

unfreeze

Deletes the freeze state file to restore write access across project directories.

Community
Basic
wormholecowboywormholecowboy
1

stateResume

Load a state file from the .state directory and update its frontmatter.

Community
Basic
estaciolimaestaciolima

speckit-git-feature

Automates Git feature-branch creation and initialization in spec-kit projects.

Community
Intermediate
hffmnnjhffmnnj
39

memory-usage

Store and retrieve persistent information across sessions with memory interfaces.

Community
Basic