project-selector

Switch the active project in a monorepo via a UI prompt and persist the selection.

41|4|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/etr/groundwork --skill project-selector
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-selector
Source: https://github.com/etr/groundwork/tree/main/skills/project-selector
Command: npx skills add https://github.com/etr/groundwork --skill project-selector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams quickly switch the active project in a monorepo, simplifying context switching across multiple projects.

Core Features & Use Cases

  • List available projects from .groundwork.yml at the repo root.
  • Present options to pick a project, then set the active project context and persist the choice.
  • Show status of each project's specs (PRD, Architecture, Tasks) after switching to aid follow-up actions.

Quick Start

Switch to the desired project from the available list and confirm the active project.

Frequently Asked Questions about project-selector

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

FAQPage Schema
How do I switch the active project in a monorepo quickly?▼

To switch the active project in a monorepo, use a project selector that reads available projects from .groundwork.yml, presents a UI prompt, and updates your environment context upon selection.

What is the purpose of .groundwork.yml in a monorepo?▼

The .groundwork.yml file lists available projects at the repository root, enabling a project selector skill to parse configurations and present switchable options to the user.

Do I need a specific configuration file to switch project context?▼

Yes, switching project context requires a .groundwork.yml file at the repository root to correctly list available projects and persist your selection.

How does switching projects affect my specs status?▼

Switching projects updates the active context and immediately shows the status of each project's specs, including PRD, Architecture, and Tasks, to aid follow-up actions.

Can I persist my project selection across sessions in a monorepo?▼

Yes, the project selection is persisted across sessions using a dedicated persist script that saves your active project context after you confirm your choice.