Agent-Skills.md

Agent Skills: Node.js `package.json`

Patch a Node.js project's package.json for standard build automation. Use when asked to add/standardize package.json scripts like prebuild/postbuild for TypeScript builds (rimraf dist + tsc-alias), adjust prebuild for Next.js (rimraf dist .next), or ensure an existing package.json pkg config includes required scripts/assets/targets/outputPath.

UncategorizedID: shaowei-g/codex-skills/nodejs-package-json

Repository

shaowei-g/codex-skills
shaowei-g

Install this agent skill to your local

pnpm dlx add-skill https://github.com/shaowei-g/codex-skills/tree/HEAD/skills/nodejs-package-json

Skill Files

Browse the full folder contents for nodejs-package-json.

Download Skill

Loading file tree…

skills/nodejs-package-json/SKILL.md

Skill Metadata

Name
nodejs-package-json
Description
Patch a Node.js project's package.json for standard build automation. Use when asked to add/standardize package.json scripts like prebuild/postbuild for TypeScript builds (rimraf dist + tsc-alias), adjust prebuild for Next.js (rimraf dist .next), or ensure an existing package.json pkg config includes required scripts/assets/targets/outputPath.

Node.js package.json

Goal

Quickly and safely update package.json to include:

  • scripts.prebuild: rimraf dist (or rimraf dist .next for Next.js)
  • scripts.postbuild: tsc-alias
  • If pkg config exists: ensure scripts/assets/targets/outputPath contain required entries

Workflow

  1. Run the patcher (auto-detects Next.js):

    • python3 "${CODEX_HOME:-$HOME/.codex}/skills/nodejs-package-json/scripts/patch_package_json.py" --path package.json

  2. If Next.js auto-detection is wrong, force it:

    • Force Next.js: --nextjs true
    • Force non-Next.js: --nextjs false

  3. If prebuild or postbuild already exist with different values:

    • Re-run with --force to overwrite to the recommended defaults.

Notes

  • This skill edits package.json only; it does not install dependencies. Ensure rimraf and tsc-alias are available (typically as devDependencies).
  • The patcher only edits pkg settings if a top-level pkg object already exists (it does not add one).