session-checkpoints
Saves, restores session state including task progress, file changes, delegation history. Use when saving progress, resuming interrupted work, picking up where you left off, or checkpointing current work.
git clone --depth 1 https://github.com/monkilabs/opencastle /tmp/session-checkpoints && cp -r /tmp/session-checkpoints/src/orchestrator/skills/session-checkpoints ~/.claude/skills/session-checkpointsSKILL.md
# Skill: Session Checkpoints ## When to Checkpoint | Trigger | Action | |---------|--------| | Before first delegation | After decomposition, before agents start | | After each phase | When a parallel batch completes | | Before risky work | DB migrations, large refactors, security changes | | Session end | Any session with incomplete work | | Context running low | Checkpoint immediately | ## Checkpoint Template Full checkpoint template moved to `CHECKPOINT-TEMPLATE.md` in this directory for progressive disclosure. Use that file as canonical, copy-pasteable checkpoint document. See Decomposition Flow in `decomposition` skill for when to create checkpoints: [decomposition](../../skills/decomposition/SKILL.md). ## Checkpoint creation (quick) 1. Create `.opencastle/SESSION-CHECKPOINT.md` from example below. 2. Commit checkpoint or save to workspace; attach to tracker issue. 3. Verify: `cat .opencastle/SESSION-CHECKPOINT.md`; confirm listed files exist. ```markdown # Session Checkpoint — 2026-04-01 ## Summary Implementing search filters — unit tests passing, E2E pending. ## Files Touched - src/components/SearchFilter.tsx (new) - src/hooks/useFilters.ts (modified) ## Task Status | Task | Status | |------|--------| | TASK-12 Search filter component | Done | | TASK-13 E2E filter tests | In Progress | ## Resume Instructions 1. Run `git checkout feat/search-filters` 2. Start dev server: `pnpm dev` 3. Continue TASK-13: write E2E tests for filter interactions ``` For complete copy-pasteable template, see [CHECKPOINT-TEMPLATE.md](./CHECKPOINT-TEMPLATE.md). ## Resuming 1. Read `.opencastle/SESSION-CHECKPOINT.md` 2. Run `git status`, `git branch` — confirm you are on correct branch 3. Check In Progress tasks — if stale (>1 session old), verify files match expected state 4. Check Pending Approvals — remove rows for questions answered via VS Code chat 5. Read tracker issues for tasks marked In Progress or Todo 6. Follow Resume Instructions section in checkpoint 7. Update checkpoint progress after each completed task **If checkpoint missing or corrupt:** Rebuild from `git log --oneline -20`, tracker state. ## Cleanup & Team Lead When all issues Done: archive to tracker; delete `.opencastle/SESSION-CHECKPOINT.md`.
Creates pages/layouts, defines content collections, configures hydration directives, and wires integrations. Use when adding or modifying Astro pages, layouts, components, or content collections. Trigger terms: Astro, content collection, client:load, client:visible, astro:content
Drive real browsers via Chrome DevTools MCP: navigate pages, capture snapshots, run responsive checks, and collect console/perf traces. Use when the user mentions: 'validate UI change in Chrome', 'capture a screenshot', 'run responsive checks', or 'collect console logs'. Trigger terms: browser testing, DevTools, console logs, screenshot, responsive testing
Creates and deploys Cloudflare Workers, configures wrangler.toml bindings, sets up KV/D1/R2 storage and Durable Objects, manages Pages deployments, and implements edge function patterns. Use when building or deploying Cloudflare Workers, setting up Pages, working with KV/D1/R2 storage, configuring wrangler.toml, or deploying edge applications.
Creates Contentful content types, queries entries via GraphQL/REST, runs CLI migrations, and manages assets and locales. Use when building or modifying Contentful content models, writing queries, or migrating content.
Convex reactive database patterns, schema design, real-time queries, mutations, actions, authentication, migrations, performance optimization, and component creation. Use when designing Convex schemas, writing queries/mutations, managing the Convex backend, setting up auth, migrating data, optimizing performance, or building Convex components.
Deploys applications, databases, and services on self-hosted Coolify instances, manages environments and env vars, runs infrastructure diagnostics, and performs batch operations. Use when deploying apps to Coolify, managing Coolify servers, debugging deployment issues, setting up databases, or managing Coolify infrastructure.
Writes Cypress E2E/component tests, configures `cy.intercept()` and `cy.session()`, authors custom commands, and wires CI artifacts. Use when creating E2E specs, component tests, or CI test pipelines. Trigger terms: cypress, e2e, component test, cy.intercept, cy.session
Drizzle ORM schema definition, type-safe queries, relational queries, CRUD operations, transactions, migrations with drizzle-kit, and database setup for PostgreSQL, MySQL, and SQLite. Use when defining database schemas, writing queries or joins, managing migrations, setting up a new Drizzle project, or working with drizzle-kit.