Skip to content
cccskills
FreePublished on GitHub

ci

Maintain Node3D GitHub Actions, reusable CI patterns, install modes, matrices, native/GPU/platform limits, lint/test/build jobs, and validation semantics.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67 stars(GitHub 67 + cccskills 0)
Works withGitHub

Run score Not tested

See how to install

Files included (2)

  • SKILL.md2.5 KB
  • agents/openai.yaml173 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

CI

Owns

CI workflow behavior and what automated validation claims to prove.

Workflow

  1. Compare the target with similar package workflows before inventing a pattern.
  2. Choose install mode deliberately; use --ignore-scripts when native postinstall behavior is irrelevant or brittle.
  3. Separate portable checks from native/hardware/graphics checks.
  4. Keep workflow names, triggers, Node/npm baselines, and package commands consistent where the package model is shared.
  5. Encode unavoidable legacy/platform exceptions narrowly.
  6. If CI changes the meaning of project validation or supported platform claims, Contract Gate is YES.
  7. Preserve standalone-package workflow paths; do not assume a root workspace checkout. Use plain npm ci for native binary build workflows unless a documented reason requires --ignore-scripts.

Native Addon Baseline

Every package classified as a native addon in .agents/references/repository-model.md must validate, on pushes and pull requests:

  • TypeScript with the package type-check command;
  • TypeScript with oxlint (plus the package-root install.js lifecycle exception defined by ADR 0018);
  • C++ with cpplint and the shared CPPLINT.cfg from @node-3d/addon-tools;
  • its package-owned unit tests.

These validators may share workflows, but a package-specific platform or hardware constraint is not an omission. Any exception must be narrow and documented in the package workflow or an ADR.

Packed Consumer Gate

CI acceptance and native binary release workflows validate the actual npm tarball in an empty consumer project, without workspace linking or source/build-tree fallback. Install with lifecycle scripts enabled, load the public entry, and add only meaningful package-specific smoke behavior. Native packages that download release assets must pass their exact candidate archives to fresh downstream jobs as workflow artifacts. Create or update the GitHub release only after every consumer lane passes; passing repository tests is not a substitute. The npm publish.yml workflow only delivers the package and does not repeat this validation.

Load References

Load .agents/references/ci-platform-limits.md for GPU, OpenGL, native binary, macOS/Linux/Windows ARM, or runner-capability constraints.

Use $tests as secondary when test semantics/scripts are modified.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

compute

Free

Work on CUDA, OpenCL, GLSL compute, GL/CUDA or GL/OpenCL interop, GPU data ownership, kernels, argument packing, and compute-driven rendering.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

core

Free

Work on @node-3d/core browser-like runtime, Document/Window/canvas behavior, WebGL/Three.js compatibility, globals, context and resource behavior.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

deps

Free

Work on Node3D deps-* packages, third-party binaries/headers, getPaths/bin/include contracts, redistribution, provenance, and binary layout consumers.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

docs

Free

Write and maintain Node3D package READMEs, API text, usage snippets, package roles, platform/install notes, and source-backed consumer documentation.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

examples

Free

Create, review, or maintain Node3D runnable examples, consumer-style package imports, feature demos, vendor adaptations, assets, and example validation.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

native-addons

Free

Work on Node3D C++ addons, addon-tools bindings, binding.gyp/common.gypi, install.js, ts/native.ts, native handles, lifetime safety, and native verification.

The English summary is being prepared. Showing the original description.

node-3d/node-3d67Updated Oct 15, 2026

See all skills by node-3d

Report a problem with this skill