What project files does this skill look for?

The skill scans for package.json, PROGRESS.md, ROADMAP.md, features.json, and a solutions/ directory to build a comprehensive project summary.

Does it automatically install dependencies?

Yes, if it detects a package.json file without a corresponding node_modules folder, it will attempt to run npm install to set up the environment.

Can it identify coding errors before I start?

Yes, it specifically checks for TypeScript errors and failing tests to report any blockers that might affect your work session.

How does the solutions library search work?

It uses keyword extraction from your current task to grep through local project solutions and global solutions stored in ~/.claude/solutions/.

What happens if I don't have a roadmap file?

The skill handles missing files gracefully and will suggest running the /roadmap skill to help you create a task breakdown.

Session Start Protocol

Name: Session Start Protocol
Author: matthewod11-stack

bymatthewod11-stack

•

Productivity & Workflow

Standardizes the beginning of a coding session by verifying environment health, reviewing progress, and identifying the next priority task.

The Session Start Protocol is an essential workflow automation tool for Claude Code that eliminates manual context-gathering at the start of a development session. It automatically scans project documentation such as ROADMAP.md and PROGRESS.md, verifies environment stability, searches for relevant architectural solutions, and identifies blockers like uncommitted changes or failing tests. By providing a structured summary of the project's current state, it ensures that both the developer and the AI agent can transition immediately into productive work with full context and clear objectives.

Key Features

01Automated environment verification and dependency installation

02Real-time blocker identification including Git status and TypeScript errors

03Context retrieval from PROGRESS.md and ROADMAP.md files

04Standardized session summaries with clear next-task guidance

05Intelligent keyword search across local and global solution libraries

061 GitHub stars

Use Cases

01Standardizing project status reporting and task tracking for AI-assisted workflows

02Ensuring environment consistency before starting new feature development

03Regaining context quickly when returning to a project after a break

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add matthewod11-stack/claude-setup session-start

For use in Claude.ai and ChatGPT

Download Skill