1
49%
main: 48%

Ran 17 May 2026 04:30PM UTC

Files 75

Run time 1s

Badge

Embed ▾

Committed 17 May 2026 04:27PM UTC coverage: 48.672%. Remained the same

Job # 25996374135.1

Build Type

push

github

Committed by

ArangoGutierrez

Commit Message

docs(skill): document flag-first ordering pitfall in using-holodeck SKILL.md

When an AI agent reads using-holodeck/SKILL.md it copy-pastes the
commands verbatim, so any example in the broken `<id> --flag` form
makes the agent's first attempt fail in a way that's hard to diagnose
without reading urfave/cli/v2 source.

Three classes of fix in this file:

- Rewrite the `update` and `get kubeconfig` examples so flags come
  before the positional instance id (e.g. `update --instance-type … <id>`,
  `get kubeconfig -o ./kubeconfig <id>`). The `<id>` positional has to
  be last for the same urfave/cli/v2 reason.

- Make `cleanup` examples explicit that `--region us-west-2` (or
  `AWS_REGION=us-west-2` env) is required — `cleanup` does not infer
  the region from the saved instance metadata.

- Two new "Common pitfalls" entries:
    * Instance IDs are short hex strings (`a1b2c3d4`), not
      EC2-style `i-…` ARNs. Agents routinely confuse the two.
    * Flag-first ordering — `urfave/cli/v2` stops parsing flags after
      the first positional, with a pointer to which commands this
      bites (update, get kubeconfig, cleanup, skill add).

Signed-off-by: Carlos Eduardo Arango Gutierrez <eduardoa@nvidia.com>

Coverage Stats

5606 of 11518 relevant lines covered (48.67%)

0.54 hits per line

NVIDIA / holodeck / 25996374135 / 1
49%
main: 48%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 25996374135.1

NVIDIA / holodeck / 25996374135 / 1 49% main: 48%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 25996374135.1

NVIDIA / holodeck / 25996374135 / 1
49%
main: 48%

README BADGES
x