Skip to content

chore(skills): add tags frontmatter to four bring-up skills - #10069

Merged
dagil-nvidia merged 5 commits into
mainfrom
chore/nvskills-trigger-validation
May 28, 2026
Merged

chore(skills): add tags frontmatter to four bring-up skills#10069
dagil-nvidia merged 5 commits into
mainfrom
chore/nvskills-trigger-validation

Conversation

@dagil-nvidia

@dagil-nvidia dagil-nvidia commented May 27, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds an agentskills.io-compatible `tags:` field to each of the four bring-up skills under `skills/`. Matches the convention used by the reference `NVIDIA/nvskills-ci/skills/ci-smoke-test/SKILL.md`. No body, references, scripts, or evals changed.

Why

PR #10017 (merged) triggered the NVSkills CI signing flow end-to-end for the first time. The downstream GitLab pipeline (52784444) reached `validate:content` and failed there, with no per-skill error message surfaced back to the GitHub run. Signing was skipped as a result.

This PR:

  • Re-triggers the dispatch path on a new `skills/...` diff, so a fresh GitLab `validate:content` log is available to inspect.
  • Adds `tags:` — a plausible candidate for the missing field that caused the prior validate:content failure (current frontmatter has only `name` + `description`).

If `tags` was the issue, this PR clears `validate:content` and the bot attaches signatures. If not, the fresh GitLab log gives the actual diagnostic.

Test plan

  • Comment `/nvskills-ci` on this PR
  • Confirm the source-side wrapper dispatches (no more "path is not allowed")
  • Inspect the new GitLab `validate:content` log either passes or surfaces a clearer per-skill error

🤖 Generated with Claude Code


Open in Devin Review

Summary by CodeRabbit

  • Chores
    • Added metadata tags across multiple Dynamo skills, including classifications for routing, troubleshooting, Kubernetes, validation, and recipe management capabilities.

Review Change Stack

@github-actions github-actions Bot added chore documentation Improvements or additions to documentation labels May 27, 2026
@dagil-nvidia

Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

@coderabbitai

coderabbitai Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 1704288c-ba0e-4718-9781-3516405476aa

📥 Commits

Reviewing files that changed from the base of the PR and between 1b0a003 and 573efbe.

📒 Files selected for processing (4)
  • skills/dynamo-interconnect-check/SKILL.md
  • skills/dynamo-recipe-runner/SKILL.md
  • skills/dynamo-router-starter/SKILL.md
  • skills/dynamo-troubleshoot/SKILL.md

Walkthrough

Four skill definition files are updated with YAML front-matter tags fields for categorization: dynamo-interconnect-check, dynamo-recipe-runner, dynamo-router-starter, and dynamo-troubleshoot each receive domain-specific tags for improved discovery and filtering within the skill registry.

Changes

Skill metadata tagging

Layer / File(s) Summary
Add categorization tags to skill front matter
skills/dynamo-interconnect-check/SKILL.md, skills/dynamo-recipe-runner/SKILL.md, skills/dynamo-router-starter/SKILL.md, skills/dynamo-troubleshoot/SKILL.md
Four skill definition files receive new tags arrays in their YAML front matter. Interconnect check is tagged with dynamo, nixl, rdma, disagg, and validation; recipe runner with dynamo, kubernetes, and recipes; router starter with dynamo, router, smoke-test, and bring-up; troubleshoot with dynamo, kubernetes, troubleshooting, and day-2.

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding tags frontmatter to four bring-up skills.
Description check ✅ Passed The description provides clear context, motivation, and test plan but omits 'Details' and 'Where should the reviewer start?' template sections.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions

github-actions Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

@dagil-nvidia

Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

@copy-pr-bot

copy-pr-bot Bot commented May 28, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@pull-request-size pull-request-size Bot added size/L and removed size/S labels May 28, 2026
@dagil-nvidia

Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

@dagil-nvidia
dagil-nvidia requested review from a team as code owners May 28, 2026 00:28
@dagil-nvidia

Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

dagil-nvidia and others added 5 commits May 27, 2026 21:37
Touches each of the four skills under skills/ to add agentskills.io-compatible
'tags' fields. Matches the convention used by the NVIDIA/nvskills-ci reference
skill (skills/ci-smoke-test/SKILL.md).

Primary purpose: re-trigger the NVSkills CI validation flow that was first
exercised on PR #10017 (now merged). That dispatch reached the downstream
GitLab pipeline 52784444 but failed at validate:content with no per-skill
detail in the GitHub-side log. This PR re-runs the path so the GitLab
validate:content log is fresh and inspectable, and adds a frontmatter field
that may be the underlying validation gap.

No content changes; SKILL.md bodies, references, scripts, and evals are
unmodified.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Dan Gil <dagil@nvidia.com>
…kills

NVSkills CI validate:content rejected the four skills because they lack a
license declaration in frontmatter. Add 'license: Apache-2.0' to each
SKILL.md.

Existing per-file SPDX headers are unchanged (SKILL.md / references/*.md
remain CC-BY-4.0 for skill content; scripts/*.py remain Apache-2.0 for code).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Dan Gil <dagil@nvidia.com>
Signed-off-by: Dan Gil <dagil@nvidia.com>
…kills

NV-BASE 2.12.0 validation returned 16 issues per skill (1 critical LICENSE,
7 medium SCHEMA/QUALITY, 8 low). LICENSE was fixed in the previous commit;
this commit addresses the rest.

Frontmatter restructure (all four):
- Move 'tags' under 'metadata' (SKILL_SPEC location for recommended fields)
- Add 'metadata.author' (Dan Gil <dagil@nvidia.com>)
- recipe-runner: add 'metadata.permissions' (file_read, network, kubectl_exec)
  per the LP3 security finding on that skill

SKILL.md body additions (all four):
- '## Goal' -> '## Purpose' (QUALITY discoverability)
- '## Workflow' -> '## Instructions' (SCHEMA recommended section)
- Add '## Prerequisites' (QUALITY reliability)
- Add '## Available Scripts' with the | Script | Purpose | Arguments | table
  the validator expects (QUALITY correctness)
- Add '## Examples' block referencing the run_script() agent protocol
- Add '## Limitations' (QUALITY reliability)
- Add '## Troubleshooting' (QUALITY reliability)

Script lint fixes:
- Add '#!/usr/bin/env python3' shebang and set the executable bit on all four
- Extract magic numbers to module-level named constants in three scripts:
  - check_router_health.py: DEFAULT_HTTP_TIMEOUT_SEC, DEFAULT_RETRIES,
    DEFAULT_RETRY_SLEEP_SEC, DEFAULT_MAX_TOKENS, HTTP_OK, EXIT_* codes
  - collect_dynamo_debug_bundle.py: DEFAULT_KUBECTL_TIMEOUT_SEC,
    DEFAULT_LOG_TAIL_LINES, RETURNCODE_COMMAND_NOT_FOUND, RETURNCODE_TIMED_OUT
  - check_interconnect.py: DEFAULT_PROBE_TIMEOUT_SEC, RETURNCODE_COMMAND_NOT_FOUND

Description trimming (221-286 chars; validator recommends 50-150) is
intentionally NOT in this commit; long-form trigger keywords are load-bearing
for skill-routing accuracy.

py_compile clean on all four scripts; YAML frontmatter parses on all four
SKILL.md files.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Dan Gil <dagil@nvidia.com>
Signed-off-by: Dan Gil <dagil@nvidia.com>
@dagil-nvidia
dagil-nvidia force-pushed the chore/nvskills-trigger-validation branch from b5b9f88 to 35c5a10 Compare May 28, 2026 02:38
@dagil-nvidia
dagil-nvidia enabled auto-merge (squash) May 28, 2026 02:38
@dagil-nvidia
dagil-nvidia disabled auto-merge May 28, 2026 02:49
@dagil-nvidia
dagil-nvidia merged commit 8881c21 into main May 28, 2026
66 checks passed
@dagil-nvidia
dagil-nvidia deleted the chore/nvskills-trigger-validation branch May 28, 2026 02:49
tmonty12 pushed a commit that referenced this pull request Jun 8, 2026
Signed-off-by: Dan Gil <dagil@nvidia.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: nvskills-svc-account <svc-nvskills-signing@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

chore documentation Improvements or additions to documentation size/XL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants