os-switch-project
Automates the process of saving current work and switching to a different project context.
Install
mkdir -p .claude/skills/os-switch-project && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12310" && unzip -o skill.zip -d .claude/skills/os-switch-project && rm skill.zipInstalls to .claude/skills/os-switch-project
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Switch the active project. Optionally saves the current session and instructs the user to clear context. Run /os-start in the new session to choose a project and load context.Key capabilities
- →Offer to save the current session
- →List all active projects from `projects.md`
- →Allow selecting an existing project
- →Allow adding a new project
- →Update `Last session:` field for selected project
- →Instruct user to clear context and load new project
How it works
The skill guides the user through saving their current session, selecting a new project from a list, or adding a new one. It updates project metadata and provides instructions for resetting context and loading the new project.
Inputs & outputs
When to use os-switch-project
- →Switching active development projects
- →Saving session state
- →Starting a new project workspace
- →Resetting agent context
About this skill
/os-switch-project — Switch Project
Cleanly switches from the current active project to a new one across a context boundary.
Step 1 — Offer to save current session
Ask:
Switching projects.
Save this session before switching? (Y/n)
If yes: run /os-save.
If no: continue.
Step 2 — Choose new project
Read projects.md and list all Active projects. Count them, then add one final option dynamically:
Switch to which project?
1. [Project Name]
2. [Project Name]
3. [Project Name]
[...all active projects from projects.md...]
N. Add a new project
Wait for selection.
Step 3 — Handle selection
If an existing project is selected:
If the user skipped /os-save in Step 1, update the Last session: field for that project in projects.md to today's date.
Print:
Now working on [New Project Name].
Run /clear to reset context, then /os-start to load the new project.
If "Add a new project" is selected:
Run /os-new-project.
Notes
- There is no longer an "Active project" line in root
CLAUDE.md. Project selection happens at/os-starttime. - The switch takes effect after
/clear. Run/os-startin the new session to select and load a project.
When not to use it
- →When the user wants to continue working on the current project
Limitations
- →Project selection takes effect only after `/clear`
- →Requires `/os-start` to load the new project in a new session
How it compares
This skill provides a structured process for switching projects and managing session state, contrasting with an unstructured approach that might lead to lost work or context issues.
Compared to similar skills
os-switch-project side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| os-switch-project (this skill) | 0 | 3mo | No flags | Beginner |
| linear | 10 | 2mo | No flags | Beginner |
| zapier-workflows | 11 | 8mo | Review | Beginner |
| attio-skill-generator | 7 | 7mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by simonconway1979
View all by simonconway1979 →You might also like
linear
lobehub
Linear issue management guide. Use when working with Linear issues, creating issues, updating status, or adding comments. Triggers on Linear issue references (LOBE-xxx), issue tracking, or project management tasks. Requires Linear MCP tools to be available.
zapier-workflows
davila7
Manage and trigger pre-built Zapier workflows and MCP tool orchestration. Use when user mentions workflows, Zaps, automations, daily digest, research, search, lead tracking, expenses, or asks to "run" any process. Also handles Perplexity-based research and Google Sheets data tracking.
attio-skill-generator
kesslerio
Generate use-case-specific Attio workflow skills from templates. Use when creating new skills for lead qualification, deal management, customer onboarding, or custom Attio workflows.
automation-brainstorm
MacroMan5
Interactive workflow design advisor for Power Automate, n8n, Make, Zapier and other platforms. Guides users through planning automation workflows with smart questions about triggers, actions, data flow, and error handling. Uses research sub-agent to find best practices and generates detailed implementation plan. Triggers when user mentions "create workflow", "build flow", "design automation", "need ideas for", or describes workflow requirements without having a complete design.
daily-briefing
anthropics
Start your day with a prioritized sales briefing. Works standalone when you tell me your meetings and priorities, supercharged when you connect your calendar, CRM, and email. Trigger with "morning briefing", "daily brief", "what's on my plate today", "prep my day", or "start my day".
jira
davila7
Use when the user mentions Jira issues (e.g., "PROJ-123"), asks about tickets, wants to create/view/update issues, check sprint status, or manage their Jira workflow. Triggers on keywords like "jira", "issue", "ticket", "sprint", "backlog", or issue key patterns.