startup-check

Recover pending handoff tasks and validate Git environment at session startup.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/tarrragon/ccsession --skill startup-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: startup-check
Source: https://github.com/tarrragon/ccsession/tree/main/.claude/skills/startup-check
Command: npx skills add https://github.com/tarrragon/ccsession --skill startup-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill performs startup health checks for Claude Code sessions, recovering pending handoff tasks, validating Git environment, and confirming development readiness.

Core Features & Use Cases

  • Handoff recovery: scans .claude/handoff/pending for items that haven't been resumed and fetches their full ticket content for immediate action.
  • Git and environment verification: reports current branch, status, and recent commits to ensure a clean baseline.
  • Development readiness: checks for essential files (CLAUDE.md, FLUTTER.md, pubspec.yaml) and overall project health to enable smooth session startup.

Quick Start

Run /startup-check to perform an automated startup health check and recover any pending tasks.

Frequently Asked Questions about startup-check

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

FAQPage Schema
How do I verify my Git environment and workspace state when starting a new code session?

To verify your Git environment and workspace state at session startup, you can run an automated health check that reports your current branch, status, recent commits, and confirms essential project files exist for a clean baseline.

How do I recover pending handoff tasks after an interrupted development session?

To recover pending handoff tasks after an interruption, scan the .claude/handoff/pending directory to find unfinished items and fetch their full ticket content for immediate action and quick recovery.

Can I check development readiness for essential project files like CLAUDE.md and pubspec.yaml automatically?

Yes, you can check development readiness automatically by verifying the presence of essential project files like CLAUDE.md, FLUTTER.md, and pubspec.yaml to ensure smooth session startup and overall project health.

What is the best way to establish a clean baseline before resuming ongoing development work?

The best way to establish a clean baseline before resuming development work is running an automated startup health check that validates your Git status, monitors workspace state, and recovers pending handoff tasks with deterministic steps and safe defaults.

Does session startup verification work without any additional dependencies or external tools?

Yes, session startup verification works without additional dependencies, applying deterministic steps and safe defaults to monitor your workspace state, branch, recent commits, and essential project files independently.

Why does my session startup check fail to find pending handoff tasks in my workspace?

Session startup checks fail to find pending handoff tasks when the .claude/handoff/pending directory is empty or missing, meaning no interrupted items exist to recover for immediate action.