Add ARD (Agentic Resource Discovery) catalog#324
Open
elvinagam wants to merge 3 commits into
Open
Conversation
ec314b0 to
487f9fd
Compare
Signed-off-by: elvinagam <eaghammadzad@nvidia.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Fixes test_every_skill_has_catalog_entry failure — this consolidated skill was added to skills/ but never given a catalog entry. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Signed-off-by: elvinagam <eaghammadzad@nvidia.com>
…ation-api-{c,cli}
Upstream commit 1f01acf removed these orphaned skill dirs after they
were consolidated into cuopt-numerical-optimization-api. Drop their
now-stale catalog entries to match.
Signed-off-by: elvinagam <eaghammadzad@nvidia.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds an Agentic Resource Discovery (ARD) catalog so external agents/tools can discover NVIDIA's skills programmatically, instead of only through the
skills/directory listing.docs/.well-known/ai-catalog.json— ARD-compliant catalog with one entry per skill inskills/(identifier, display name, description, and representative search queries for each).github/workflows/publish-catalog.yml— publishesdocs/(including the catalog) to GitHub Pages on push tomain.github/workflows/validate-ai-catalog.yml— runs the integration tests on PRs/pushes that touch the catalog,skills/**/SKILL.md, or the test file itselftests/integration/test_catalog.py— asserts the catalog is valid JSON, every skill inskills/has a matching entry (and vice versa, no stale entries), and every entry has the required ARD fields (identifier,type,url,description,representativeQueries)CONTRIBUTING.md— documents the checklist for adding a catalog entry when contributing a new skillCHANGELOG.md— notes the addition under[Unreleased]Test plan
pytest tests/integration/test_catalog.pypasses locally (5/5)validate-ai-catalog.ymlworkflow passes in CIpublish-catalog.ymldeploys anddocs/.well-known/ai-catalog.jsonis reachable at the published GitHub Pages URLOnboarding type
components.d/<slug>.ymlfile)For new product onboarding — author affirmations
By submitting this PR, I confirm on behalf of my team:
.agents/skills/orskills/path used for new entries (or existing path retained for legacy entries percomponents.d/<slug>.yml)Reviewer checklist (OSS Skills PIC)
components.d/<slug>.ymlentry valid (required fields, uniquecatalog_dir, path exists in source repo, filename slug matches name)SKILL.mdfrontmatter spec-compliant (at least one sampled)All PRs
git commit -s).If you forgot, run
git rebase --signoff origin/main && git push --force-with-leaseto retroactively sign all commits in your branch.Other context (for non-onboarding PRs)