メニュー
pnpm workspace monorepo management with filtering, catalogs, and shared configs. Use when setting up monorepos, managing workspace dependencies, filtering package commands, or sharing configuration across packages.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
E2E test architecture and patterns with Playwright. Use when designing test suites, structuring Page Object Models, planning CI sharding strategies, setting up authentication flows, or organizing tests with tags and annotations. Use for test architecture, accessibility auditing with axe-core, network mocking strategies, visual regression workflows, HAR replay, and storageState authentication patterns. For Playwright API details, browser automation, or web scraping, use the playwright skill instead.
Playwright browser automation API, web scraping, and tooling. Covers locator strategies, assertions, API testing, stealth mode, anti-bot bypass, authenticated sessions, screenshots/PDFs, Docker deployment, configuration, debugging, and MCP integration with AI agents. Prevents documented errors including CI timeout hangs, extension testing failures, and navigation issues. Use when automating browsers, scraping protected sites, bypassing bot detection, generating screenshots/PDFs, configuring Playwright Test, troubleshooting Playwright errors, or learning Playwright API patterns. For E2E test architecture, Page Object Models, CI sharding strategies, or test organization patterns, use the e2e-testing skill instead.
Type-safe, file-based React routing with route loaders, search params validation, code splitting, preloading, navigation, route context, and TanStack Query integration. Use when setting up file-based routing, adding search params validation, implementing route loaders, code splitting routes, configuring virtual file routes, protecting routes with auth guards, or fixing type registration errors. Use for router setup, navigation patterns, URL state management, data loading.
Zod v4 schema validation for TypeScript. Covers primitives, string formats, objects, arrays, unions, coercion, transforms, refinements, parsing, type inference, error customization, JSON Schema, file validation, and metadata. Use when writing schemas, validating input, parsing data, inferring types, or converting schemas with Zod.
TanStack Table v8 headless data tables for React. Covers column definitions, sorting, filtering (fuzzy/faceted), server-side pagination with TanStack Query, infinite scroll, virtualization (TanStack Virtual), column/row pinning, row expanding/grouping, column resizing, and reusable Shadcn-styled components. Prevents 15 documented errors including infinite re-renders, React Compiler incompatibility, and server-side state mismatches. Use when building data tables, fixing table performance, implementing server-side pagination, adding filtering/sorting, or debugging table state issues.
Drizzle ORM for type-safe SQL with PostgreSQL, MySQL, and SQLite. Use when defining schemas, writing queries, managing relations, running migrations, or using drizzle-kit. Use for drizzle, orm, schema, query, migration, pgTable, relations, drizzle-kit, drizzle-zod.
| name | pnpm-workspace |
| description | pnpm workspace monorepo management with filtering, catalogs, and shared configs. Use when setting up monorepos, managing workspace dependencies, filtering package commands, or sharing configuration across packages. |
| license | MIT |
| metadata | {"author":"oakoss","version":"1.2","source":"https://pnpm.io/workspaces"} |
| user-invocable | false |
pnpm workspaces provide built-in monorepo support through pnpm-workspace.yaml, the workspace: protocol for local package linking, and powerful filtering to run commands across specific packages. Catalogs enforce consistent dependency versions across all workspace packages.
When to use: Multi-package repositories, shared libraries with consuming apps, consistent dependency management across packages, running commands on subsets of packages.
When NOT to use: Single-package projects, projects already using npm/yarn workspaces (migration required), projects that need floating dependency versions per package.
| Pattern | API / Config | Key Points |
|---|---|---|
| Define workspace | pnpm-workspace.yaml with packages globs | Globs match directories containing package.json |
| Link local package | "dep": "workspace:*" | Always resolves to local workspace package |
| Link with version range | "dep": "workspace:^1.0.0" | Fails install if local version does not satisfy range |
| Default catalog | catalog: key in pnpm-workspace.yaml | Single source of truth for dependency versions |
| Named catalog | catalogs: key with named groups | Multiple version sets (e.g., react18, react17) |
| Use catalog in package | "dep": "catalog:" or "dep": "catalog:name" | Resolved to actual version on pnpm publish |
| Filter by name | --filter <name> or -F <name> | Exact name or glob pattern (@scope/*) |
| Filter with dependencies | --filter "foo..." | Package and all its dependencies |
| Filter with dependents | --filter "...foo" | Package and all packages that depend on it |
| Filter by directory | --filter "./packages/app" | All packages under a directory path |
| Filter by git changes | --filter "[origin/main]" | Packages changed since a commit or branch |
| Exclude from filter | --filter "!foo" | Remove matching packages from selection |
| Run script in package | pnpm --filter <pkg> <script> | Runs script only in matched packages |
| Recursive run | pnpm -r run <script> | Runs script in all workspace packages |
| Install all | pnpm install | Single lockfile for entire workspace |
| Publish workspace pkg | pnpm publish | Replaces workspace: and catalog: with real versions |
| Inject workspace deps | inject-workspace-packages=true in .npmrc | Hard-links instead of symlinks; required for deploy |
| Script security (v10+) | allowBuilds in package.json | Lifecycle scripts blocked by default; opt-in per dep |
| Mistake | Correct Pattern |
|---|---|
Using workspace:* then publishing as-is | pnpm automatically replaces workspace:* with real versions on publish |
Forgetting to list directory in packages: | Every package directory must match a glob in pnpm-workspace.yaml |
Using npm install in workspace packages | Always use pnpm install from the workspace root |
| Hardcoding versions duplicated across packages | Use catalog: to centralize version definitions |
Running pnpm install inside a sub-package | Run from workspace root; use --filter to target packages |
Expecting --filter to match directory names | --filter matches package.json name field, not directory names |
Not escaping ! in zsh for exclude filters | Use \! or quote the filter: --filter="!foo" |
Using workspace: for non-workspace deps | workspace: protocol only works for packages defined in the workspace |
| Lifecycle scripts failing after pnpm 10 upgrade | pnpm 10 blocks scripts by default; add deps to allowBuilds in config |
Using pnpm deploy without inject-workspace-packages | Set inject-workspace-packages=true in .npmrc (required in pnpm 10) |
Explore agent to discover existing package structureTask agent to check version consistency across packagesIf the
turboreposkill is available, delegate build orchestration, task caching, and CI optimization to it. If thechangesetsskill is available, delegate versioning, changelog generation, and npm publishing to it.