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.