skills.rest
commercetools
commercetoolsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

repo-healthcheck-node

Verify Node.js and pnpm versions, install dependencies, and run builds.

154|28|Updated Aug 31, 2018
Search Tags:#onboarding#troubleshooting#pnpm#nodejs#healthcheck#ci#dev-environment
One-click install
npx skills add https://github.com/commercetools/ui-kit --skill repo-healthcheck-node
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-healthcheck-node
Source: https://github.com/commercetools/ui-kit/tree/main/.agents/skills/repo-healthcheck-node
Command: npx skills add https://github.com/commercetools/ui-kit --skill repo-healthcheck-node

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill verifies that a Node.js/TypeScript repository's development environment is correctly configured so developers and CI systems can install dependencies and build the project reliably.

Core Features & Use Cases

  • Version checks: Reads AGENTS.md and CLAUDE.md, then checks Node.js and pnpm versions via .nvmrc, .node-version, and package.json engines.
  • Dependency and build validation: Runs the repository's install and build commands, captures exit codes and tail output, and reports concise pass/fail results.
  • Automated fixes (optional): When invoked with --fix, attempts safe remedies such as running pnpm install or installing pnpm globally, useful for onboarding, CI troubleshooting, and fresh clones.

Quick Start

Run a healthcheck on this repository, report Node.js and pnpm versions, attempt pnpm install and pnpm build, and try automated fixes if --fix is included.

Frequently Asked Questions about repo-healthcheck-node

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify my Node.js dev environment is ready for a fresh clone?▼

To verify a Node.js dev environment, check Node.js and pnpm versions against .nvmrc and package.json engines, then run pnpm install and pnpm build to validate dependencies and builds.

What is a Node.js repository healthcheck and when do I need one?▼

A Node.js repository healthcheck validates that version constraints, dependency installation, and build scripts execute correctly. It is needed during onboarding, CI troubleshooting, and fresh clones for reliable setup.

Can I automatically fix pnpm install failures during CI troubleshooting?▼

Yes, you can automatically fix pnpm install failures by running the healthcheck with the --fix flag, which attempts safe remedies like installing pnpm globally or rerunning dependency installation.

Does the healthcheck read project constraints from AGENTS.md and CLAUDE.md?▼

Yes, the healthcheck reads AGENTS.md and CLAUDE.md to gather project constraints before checking Node.js and pnpm versions via .nvmrc, .node-version, and package.json engines.

Why does my Node.js build fail after switching versions on a fresh clone?▼

A Node.js build may fail if the Node.js or pnpm version mismatches .nvmrc or package.json engines constraints. Run a healthcheck to capture exit codes, tail output, and identify the mismatch.

Related Skills

Explore More Software Engineering Skills→
iludeilude
8

web-projects

Detect frameworks and package managers in JavaScript/TypeScript web projects.

Community
Intermediate
UiPathUiPath
18

apollo-install

Clone the apollo-ui repository, install dependencies, build packages, and start Storybook on port 6006.

Official
Intermediate
cbbkrd-techcbbkrd-tech

ln-514-regression-checker

Automates execution of pytest, jest, vitest and go test suites to detect regressions.

Community
Intermediate
amotion-aiamotion-ai

test

Run backend pytest suites and Vite frontend builds to detect regressions.

Official
Intermediate