skills.rest
Serien3
Serien3COMMUNITY
Explore all skills by this author →
GitHub

start-session

Initialize a superspec work session by reading STATE.md and querying blockers.

Updated Aug 27, 2026
Search Tags:#workflow#blockers#session#start-session#superspec#feature-binding
One-click install
npx skills add https://github.com/Serien3/SuperSpec --skill start-session-serien3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: start-session
Source: https://github.com/Serien3/SuperSpec/tree/main/src/superspec/skills/start-session
Command: npx skills add https://github.com/Serien3/SuperSpec --skill start-session-serien3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start-session automates the initial work-session setup in a superspec repository by recovering the current feature state, binding the session to the active feature, and surfacing blockers to decide whether implementation can continue.

Core Features & Use Cases

  • Recover and bind: retrieves the current feature context and binds the session to it for coherent work.
  • Blocker inspection: queries pending blockers and presents actionable guidance to resolve them before proceeding.
  • Resume guidance: reads the saved STATE and provides a plan for the next steps, ensuring safe continuation.

Quick Start

Start a new work session from the repository root to align with the active feature and blockers.

Frequently Asked Questions about start-session

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

FAQPage Schema
How do I start a work session and recover the current feature state in a superspec repository?▼

To start a superspec work session, run the session initialization from the repository root. It reads the latest commit and .superspec/<feature>/STATE.md to recover the current feature state, binds the session to that feature, and provides resume guidance for the next steps.

What is feature binding and how does it work when starting a superspec work session?▼

Feature binding during a superspec work session retrieves the current feature context and binds the session to it. This ensures coherent work by aligning your session with the active feature state recovered from the latest commit and STATE.md file.

Do I need a superspec repository to use session initialization for feature state recovery?▼

Yes, session initialization applies to developers starting work in a superspec repository. It requires the .superspec/<feature>/STATE.md file to recover the current feature state and validate blockers before implementation can continue.

What's the best way to automate work session setup and inspect blockers in a superspec workflow?▼

Automating work session setup involves running the session initialization from the repository root. It automatically reads the latest commit, recovers the feature state from STATE.md, queries blockers, and guides the next steps to resume work without manual state recovery.

Related Skills

Explore More Software Engineering Skills→
Keiji-MiyakeKeiji-Miyake

developer

Implement features from SPEC.md and DESIGN.md across languages and projects.

Community
Intermediate
Lin117-shygoLin117-shygo

record-session

Create session entries from git history and commit hashes.

Community
Intermediate
MatrixFounderMatrixFounder
4

skill-session-state

Persist and restore agent session context in a YAML file with locking.

Community
Intermediate
elithrarelithrar
190

summarize-work

Analyze session history and git state to generate structured commit-message summaries.

Community
Basic