context-switch

Coordinate project and epic transitions with HEALTH checks via context-switch.sh.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/nonlinear/skills --skill context-switch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-switch
Source: https://github.com/nonlinear/skills/tree/main/context-switch
Command: npx skills add https://github.com/nonlinear/skills --skill context-switch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

Prevents context confusion during multi-project work by orchestrating conscious transitions between projects and epics using HEALTH checks, and by surfacing gaps between documentation and reality.

Core Features & Use Cases

  • Morning ritual loads the main context and can activate additional projects on weekdays.
  • Switches between projects or epics with HEALTH checks and updates the current context.
  • Evening ritual closes the current project, records a victory lap, and logs activity for later review.
  • Triggers and prompts guide AI-driven switching, such as morning, switch, and evening phrases.

Quick Start

Initiate a switch by saying the target project or epic name (e.g., wiley or fitness-tracker).

Frequently Asked Questions about context-switch

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

FAQPage Schema
How do I manage context switching across multiple projects without losing track of state?

You can automate multi-project transitions by triggering a CLI-like surface that reads HEALTH.md, updates a JSON context store, and logs switch history. Initiating a switch requires stating the target project or epic name to guard against unknown targets.

What is a HEALTH check in multi-project workflow automation?

A HEALTH check validates project status by reading HEALTH.md files before transitioning contexts. This mechanism surfaces gaps between documentation and reality, ensuring conscious switches between projects or epics while maintaining an updated JSON context store.

How do I set up morning and evening project management rituals for multiple projects?

Trigger morning or evening phrases to load main contexts, activate weekday projects, and close current projects. The evening ritual records a victory lap and logs activity for later review, while morning loads the main context and activates additional projects.

Does context-switch require jq to manage epic transitions and project state?

Yes, jq is required as a dependency to manage epic transitions and project state. The skill uses jq alongside scripts to process JSON context stores and coordinate HEALTH checks across backstage contexts during project and epic switches.

What happens if I try to switch to an unknown project or epic target?

Guards validate the target before transitioning, blocking switches to unknown project or epic targets. The skill reads HEALTH.md and updates a JSON context store only for recognized targets, preventing context confusion from invalid switches.

Best way to log activity and close a project at the end of the day?

Use an evening ritual trigger to close the current project context, record a victory lap, and log switch history. This approach stores activity data in a JSON context store for later review, ensuring conscious daily closure across multiple projects.