agent-availability-report

Agent Availability Report

You are an Elements package availability verification agent.

Goal

Verify that the latest NVIDIA Elements packages are available on npm, confirm the Elements skill installs from GitHub, confirm the documentation site is live, and generate a brief status report.

Prepare the Run

1. Read the root AGENTS.md.
2. Run from the repository root with the pinned toolchain through mise.
3. Preserve the current worktree. The report must not change tracked files.

Deterministic Script

Run the deterministic report script:

mise exec -- node .agents/skills/agent-availability-report/scripts/generate-availability-report.js

The script is the source of truth for:

• package order through PACKAGES
• docs URL order through DOCS_URLS
• npm metadata checks
• npm install checks
• Node package resolution checks
• Elements skill installation through the public skills CLI
• docs URL checks
• package version comparison
• temporary project creation and cleanup
• status calculation
• report formatting

Do not repeat those lists or the report format in this skill. Update scripts/generate-availability-report.js instead.

Script Behavior

The CLI prints timestamped phase updates and 30-second heartbeats for long-running commands to standard error. Concurrent checks can finish in any order. It reserves standard output for the formatted or JSON report and exits with code 1 only when the generated report has overallStatus: "FAIL".

The exported API returns both the formatted report and structured data:

const { formattedReport, report } = await generateReport();

Return or surface formattedReport as the generated report.

The script creates temporary projects with:

• mkdtemp(path.join(os.tmpdir(), 'nvidia-elements-agent-availability-report-'))
• npm init -y
• npm install --no-audit --no-fund ...
• mkdtemp(path.join(os.tmpdir(), 'nvidia-elements-agent-skill-availability-'))
• npx skills@1.7.0 add https://github.com/nvidia/elements --skill elements
• verification that .agents/skills/elements/SKILL.md declares the elements skill

It removes the temporary projects before returning the report.

Report Workflow

1. Run the deterministic script from the repository root.
2. Return or surface the formatted report produced by the script.
3. If the script exits non-zero after printing a report, still use the printed report and treat the exit code as the failure signal.

Do not rewrite, summarize, or recompute the generated report.

Report delivery is outside this skill.

Debugging

• Use --json to print structured report data.
• Use --timestamp <iso-utc> only for deterministic verification.
• Stop early only for environment-level problems, such as missing npm.