ReddRadar
Agent skill
root-package-json-config
Root package.json configuration for MetaSaver monorepos. Use when creating or auditing root package.json files to ensure workspace configuration, required scripts (build, dev, lint, test, format, clean), turbo pipeline scripts, packageManager field, and only devDependencies at root (no dependencies except cross-platform binaries).
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/root-package-json-config
SKILL.md
Root package.json Configuration Skill
Provides root package.json template and validation logic for MetaSaver monorepo configuration.
Purpose
Configure pnpm workspaces, monorepo scripts, package manager, devDependencies, and cross-platform compatibility.
Template
Located at: templates/root-package.json.template
The 5 Root Package.json Standards
| Rule | Requirement | Details |
|---|---|---|
| 1 | Monorepo metadata | name: @metasaver/*, private: true, packageManager: pnpm@*, engines (node, pnpm), type: "module" |
| 2 | Standard scripts | build, clean, dev, lint*, prettier*, test*, db*, docker*, setup* |
| 3 | DevDependencies only | ENSURE ONLY devDependencies (except cross-platform binaries). Place all tooling in devDependencies |
| 4 | Workspaces in YAML | USE pnpm-workspace.yaml instead of workspaces field in package.json |
| 5 | Cross-platform binaries | PLACE turbo-linux-64, turbo-windows-64 in dependencies (NOT optionalDependencies) |
Rule 1: Monorepo Metadata
{
"name": "@metasaver/project-name",
"private": true,
"packageManager": "pnpm@10.20.0",
"engines": { "node": ">=22.0.0", "pnpm": ">=9.0.0" },
"type": "module"
}
Rule 2: Required Scripts (18 total)
| Category | Scripts |
|---|---|
| Build | build, clean, dev |
| Lint/Format | lint, lint:fix, lint:tsc, prettier, prettier:fix |
| Test | test:unit, test:coverage, test:watch |
| Database | db:generate, db:migrate, db:seed, db:studio |
| Docker | docker:up, docker:down, docker:logs |
| Setup | setup:npmrc, setup:env, setup:all |
Rule 3: Required DevDependencies
Core: @commitlint/cli, @metasaver/core-eslint-config, @metasaver/core-prettier-config, dotenv, husky, lint-staged, prettier, turbo, typescript
Rule 4: No Workspaces Field
Use pnpm-workspace.yaml instead.
Rule 5: Cross-Platform Binaries
{
"dependencies": {
"turbo-linux-64": "2.6.1",
"turbo-windows-64": "2.6.1"
}
}
Validation
Validation checks (pseudo-code):
// Rule 1: Metadata
validate(
config.name?.startsWith("@metasaver/"),
config.private === true,
config.packageManager?.startsWith("pnpm@"),
config.engines?.node,
config.engines?.pnpm,
);
// Rule 2: Scripts (18 required)
const required = [
"build",
"clean",
"dev",
"lint",
"lint:fix",
"lint:tsc",
"prettier",
"prettier:fix",
"test:unit",
"test:coverage",
"db:generate",
"db:migrate",
"db:seed",
"db:studio",
"docker:up",
"docker:down",
"setup:npmrc",
"setup:env",
];
validate(required.every((s) => config.scripts?.[s]));
// Rule 3: DevDependencies
const devDeps = [
"@commitlint/cli",
"@metasaver/core-eslint-config",
"@metasaver/core-prettier-config",
"dotenv",
"husky",
"lint-staged",
"prettier",
"turbo",
"typescript",
];
validate(devDeps.every((d) => config.devDependencies?.[d]));
// Rule 4: No workspaces field
validate(!config.workspaces);
// Rule 5: Cross-platform binaries
validate(
config.dependencies?.["turbo-linux-64"],
config.dependencies?.["turbo-windows-64"],
);
Best Practices
- Use template as starting point
- ENSURE all scripts use turbo for orchestration
- PLACE cross-platform binaries in dependencies (not devDependencies)
- VERIFY only devDependencies at root (place all tooling in devDependencies only)
- RE-AUDIT after making changes
Integration
- Repository type: Use
/skill scope-checkif not provided - Workflow:
/skill audit-workflow - Remediation:
/skill remediation-options - Related:
pnpm-workspace-config,turbo-config
Didn't find tool you were looking for?