agent-nebius-auth-diagnose

Diagnose Nebius project authentication, quota reads, and selector failures without mutation.

7|5|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/nebius/nebius-ps-services --skill agent-nebius-auth-diagnose-nebius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-nebius-auth-diagnose
Source: https://github.com/nebius/nebius-ps-services/tree/main/skills/agent-nebius-auth-diagnose
Command: npx skills add https://github.com/nebius/nebius-ps-services --skill agent-nebius-auth-diagnose-nebius

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When Nebius CLI commands fail due to missing credentials, ambiguous project selection, or malformed auth selectors, this Skill performs read-only diagnosis of the current session's project and agent-auth state, classifying the failure without ever mutating credentials, profiles, or IAM. ## Core Features & Use Cases - Deterministic Project Resolution: Resolves exactly one project ID from explicit task context, workspace configuration, or the config-owned default profile's parent-id, asking the user when evidence is ambiguous. - Read-Only Auth Verification: Checks credential files, profile output, selector placement, and token minting via the setup verifier without writing files or changing IAM. - Failure Classification and Safe Retry: Distinguishes command-shape denials (retried once with a canonical leading selector) from persistent failures like project-authorization drift, missing tenant read access, or blocked admin auth, routing repair to explicit setup invocation. - Use Case: A Nebius command is denied because it lacks a leading CODEX_NEBIUS_PROJECT_ID selector; the Skill reuses the known task project, retries the corrected payload once, and reports the outcome without invoking setup. ## Quick Start Ask the agent to diagnose why your Nebius command is failing with an authentication or project error for your current task.

Frequently Asked Questions about agent-nebius-auth-diagnose

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

FAQPage Schema
How do I diagnose Nebius CLI authentication failures?

Run a read-only diagnosis that resolves the task project, checks the credential file and profile output, and verifies token minting through the setup verifier. It classifies the failure and reports either a corrected retry command or the exact explicit setup invocation needed.

How do I fix a Nebius command denied for a missing project selector?

Prefix the entire outer Bash payload with exactly one leading CODEX_NEBIUS_PROJECT_ID=<project-id> assignment as the first raw shell token, then retry once. Do not nest, duplicate, or place the selector inside wrappers like env or bash -c.

Does this diagnosis modify Nebius credentials or IAM policies?

No. Diagnosis is strictly read-only: it never writes files, rotates credentials, updates profiles, or changes IAM. When repair is needed, it reports evidence and directs the user to explicitly invoke the setup skill.

What happens when two different Nebius project IDs appear in task evidence?

The diagnosis discards any carried selection and asks the user to clarify rather than guessing. It never infers the project from ambient profiles, credential filenames, working directory, or memory.

Why does Nebius quota listing fail when project access succeeds?

This indicates missing tenant read authorization: token minting and project access work, but tenant quota-allowance listing is denied. The canonical fix is an explicit setup invocation granting tenant viewer read-only access.