Skip to content

Migrate skills to canonical 'skills/' path for nvskills-ci onboarding#132

Open
hannahli-nv wants to merge 3 commits into
mainfrom
nvskills-ci-migrate-skills-path
Open

Migrate skills to canonical 'skills/' path for nvskills-ci onboarding#132
hannahli-nv wants to merge 3 commits into
mainfrom
nvskills-ci-migrate-skills-path

Conversation

@hannahli-nv
Copy link
Copy Markdown
Collaborator

@hannahli-nv hannahli-nv commented May 26, 2026

Summary

Move the 7 cuTile skill folders from .agents/skills/ to skills/ so that nvskills-ci (added in companion PR #133) can pick up skill changes and produce signature commits.

Why

The nvskills-ci validation gatekeeper only watches the following content path prefixes:

  • skills/
  • team-skills/
  • rules/team-rules/
  • plugins/

TileGym's skills lived at .agents/skills/, which is not in this list. As a result, /nvskills-ci would be skipped with "Request is skipped with no supported changes" and no signature commit would be produced.

Layout after migration

skills/                       real directory (canonical, watched by nvskills-ci)
.agents/skills -> ../skills   symlink (backward-compat)
.claude/skills -> ../skills   symlink (backward-compat)

The symlinks preserve compatibility with Claude Code's skill loader and any agent-tool wrappers that hard-code the older paths.

Changes

  • 7 skill folders moved from .agents/skills/<name>/ to skills/<name>/ (git rename detected — full history preserved).
  • .agents/skills and .claude/skills converted to symlinks pointing at ../skills.
  • LICENSE: Sections A and B updated to include skills/ in the dual-license scope alongside the existing .agents/ / .claude/ mentions. Content unchanged — OSRB approval of the dual license travels with the files per Section B's travel clause.
  • CONTRIBUTING.md: DCO section now references skills/ as canonical with the symlinks called out as backward-compat aliases.
  • .github/scripts/check_spdx_headers.py: walker functions target skills/ directly; skills added to SKIP_DIRS so the default MIT walker does not try to put MIT headers on dual-licensed skill files.

The .github/workflows/request-nvskills-ci.yml trigger workflow is added in companion PR #133 (kept separate so it can land on main first, which is required for issue_comment-triggered workflows to fire).

Verification

  • python3 .github/scripts/check_spdx_headers.py --action check → All files have SPDX headers
  • Walker yields 7 SKILL.md frontmatter files and 34 content files (unchanged from pre-migration count)
  • All three paths (skills/, .agents/skills/, .claude/skills/) resolve to the same SKILL.md content

Order of operations

  1. Land ci: add request-nvskills-ci.yml workflow #133 first — gets the workflow file on main so /nvskills-ci comments can be processed by GitHub Actions.
  2. Wait for the dispatch token + onboardingNVSKILLS_CI_DISPATCH_TOKEN secret and TileGym in onboarded-repositories.json.
  3. This PR (Migrate skills to canonical 'skills/' path for nvskills-ci onboarding #132) becomes the end-to-end test of /nvskills-ci — once merged into main, the nv-nvskill-ci[bot] signature commit can be pushed and reviewed here.

CI Configuration

config:
  build: false
  # valid options are "ops", "benchmark", and "sanity"
  test: []

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 26, 2026

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.

@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/ok to test a885136

@hannahli-nv hannahli-nv force-pushed the nvskills-ci-migrate-skills-path branch from a885136 to d7d6643 Compare May 26, 2026 19:56
hannahli-nv added a commit that referenced this pull request May 26, 2026
Add the trigger workflow used by nvskills-ci. Matches the official
template at NVIDIA/nvskills-ci/templates/team-request-workflow.yml
(verbatim; SPDX header added to satisfy this repo's SPDX checker).

The trigger fires when:
- A maintainer/admin comments /nvskills-ci on a PR.
- nv-skills-ci[bot] pushes a signature commit titled
  "Attach NVSkills validation signatures".

Companion to PR #132 which migrates the skills/ canonical path.

Signed-off-by: Hannah Li <hanli@nvidia.com>
hannahli-nv added a commit that referenced this pull request May 26, 2026
Companion to PR #132 which migrates the skills/ canonical path.

Signed-off-by: Hannah Li <hanli@nvidia.com>
hannahli-nv added a commit that referenced this pull request May 26, 2026
Companion to PR #132 which migrates the skills/ canonical path.

Signed-off-by: Hannah Li <hanli@nvidia.com>
@hannahli-nv hannahli-nv force-pushed the nvskills-ci-migrate-skills-path branch from d7d6643 to 579a467 Compare May 26, 2026 22:40
@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

@hannahli-nv hannahli-nv force-pushed the nvskills-ci-migrate-skills-path branch 4 times, most recently from 7cf4154 to e7f4fdf Compare May 27, 2026 00:32
@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

Changes:
- Move 7 cuTile skill folders from .agents/skills/ to skills/.
- Add .agents/skills and .claude/skills symlinks pointing to ../skills
  for backward compatibility.
- Update LICENSE, CONTRIBUTING.md, and .github/scripts/check_spdx_headers.py
  to reference the new skills/ path.
- Update SKILL.md frontmatter license field to 'CC-BY-4.0 OR Apache-2.0'.
- Split skills/cutile-autotuning/SKILL.md: move API Reference,
  Step-by-Step Workflow, and Pitfall Checklist into new files under
  references/ to keep SKILL.md concise.

Signed-off-by: Hannah Li <hanli@nvidia.com>
@hannahli-nv hannahli-nv force-pushed the nvskills-ci-migrate-skills-path branch from e7f4fdf to 54960af Compare May 27, 2026 01:50
@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

These links pointed to `references/X.md`, which was correct when this
content lived in the parent SKILL.md but resolves to
`references/references/X.md` (404) now that workflow.md itself lives
inside the `references/` directory. Drop the `references/` prefix so
the links resolve to siblings.
@hannahli-nv
Copy link
Copy Markdown
Collaborator Author

/nvskills-ci

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants