Load cross-project context in monorepos. Lists available workspace projects or loads specific project context (CLAUDE.md, package.json, README, STATUS.json). Supports pnpm, npm/yarn, Lerna workspaces. Use when working in monorepo and need context from sibling projects.
From popkit-corenpx claudepluginhub jrc1883/popkit-ai --plugin popkit-coreThis skill uses the workspace's default tool permissions.
examples/implementation.mdexamples/output-formats.mdexamples/use-cases.mdtests/skill-test.jsonGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Guides Payload CMS config (payload.config.ts), collections, fields, hooks, access control, APIs. Debugs validation errors, security, relationships, queries, transactions, hook behavior.
Enables loading context from other projects in a monorepo workspace. Essential for cross-project development where you need to understand dependencies, APIs, or architecture of sibling applications.
Core principle: Seamless context switching in monorepos without manual file reading.
Trigger: Working in monorepo and need context from another project, or user runs /popkit:project reference.
Invoke when:
/popkit:project reference commandpnpm-workspace.yamlpackage.json with workspaces fieldlerna.json.claude/workspace.json/popkit:project reference
Shows all workspace projects with name, type, and path.
/popkit:project reference genesis
/popkit:project reference apps/optimus
/popkit:project reference packages/matrix
Displays:
Note: Missing files are skipped gracefully with "(No [file] found in this project)" message.
See examples/implementation.md for complete Python implementation.
Key utilities from packages/shared-py/popkit_shared/utils/workspace_config.py:
find_workspace_root() - Detect workspace rootget_workspace_projects() - List all projectsfind_project_by_name() - Find specific projectload_project_context() - Load project filesformat_project_context() - Format outputSee examples/output-formats.md for complete output examples.
Context display includes:
Not in a monorepo workspace.
Workspace markers:
- pnpm-workspace.yaml (pnpm)
- package.json with 'workspaces' field (npm/yarn)
- lerna.json (Lerna)
- .claude/workspace.json (PopKit)
Project 'invalid-name' not found.
Available projects:
- genesis
- optimus
- matrix-engine
... and 10 more
Error: PopKit shared utilities not available
Install shared-py package:
pip install -e packages/shared-py
See examples/use-cases.md for detailed scenarios.
Common patterns:
/popkit:project reference - User-facing command wrapper/popkit:project init - Create new projects/popkit:project analyze - Analyze project healthTest cases in tests/skill-test.json:
✅ Lists all projects in monorepo ✅ Loads context from named projects ✅ Handles missing files gracefully ✅ Error messages guide user to correct usage ✅ Works with pnpm/npm/yarn/Lerna workspaces
Skill Type: Utility Category: Project Management Tier: Core (Always Available) Version: 1.0.0