project-platform-diagnose

Diagnostic project overlay for environment-dependent build, install, startup, CI, container, headless, terminal, or runtime failures. Not for ordinary logic bugs or known release packaging changes.

Jump to install

Repository: n-n-code/n-n-code-skills
Last source activity: August 19, 2026 at 08:08
Detected SKILL.md language: English
Stars: 4
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/n-n-code/n-n-code-skills --skill project-platform-diagnose

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Project Platform Diagnose

This overlay can stand alone for environment-only triage. Add matching language or discipline guidance when the diagnosis reaches source code or a specialized implementation boundary.

When to use

The problem differs by operating system, architecture, terminal, shell, CI, container, headless mode, installed runtime, service environment, or another platform fact.

Not for

Do not use this as primary for a reproducible logic bug (use the matching principle skill and add project-core-dev only when repository-specific completion evidence is not concrete), a known config-contract defect (project-config-and-tests), Playwright harness or browser installation repair (setup-playwright), vendored dependency ownership (project-vendor-boundary), or release artifact layout (project-release-maintainer). Start here only while the environment remains a plausible cause, then hand off when the failure is isolated.

Diagnostic Workflow

Reproduce the exact command and capture its exit status and relevant output. Separate build or install failures from startup and runtime failures.

Record only relevant non-secret facts: OS, architecture, runtime and tool versions, shell or terminal mode, local versus CI or container, filesystem and permission assumptions, and required services. Never dump the full environment or expose credentials.

Compare a working and failing environment when both exist. Build the smallest difference set and change one plausible variable at a time.

Prefer built-in diagnostics and reproducible smoke checks. Use temporary directories, disposable containers, or other reversible probes when available; clean up created state.

Classify direct observations separately from hypotheses. Distinguish an environment limitation, missing dependency, install defect, unsupported platform, config defect, and app regression before recommending a fix.

Report whether the issue reproduced, the discriminating evidence, remaining unknowns, and the next smallest probe. Implement a code, config, setup, or release fix only when requested and with the matching skill.

Do not make permanent machine changes, install system dependencies, or start external services or GUI applications merely to test a hypothesis without the required authorization.