Skip to content

feat(skills): NVIDIA/skills trusted tap + skills.sh.json categorization (re-open, awaiting NVIDIA) - #34817

Merged
teknium1 merged 2 commits into
revert-34333-feat/nvidia-skills-tapfrom
feat/nvidia-skills-tap-reopen
May 31, 2026
Merged

feat(skills): NVIDIA/skills trusted tap + skills.sh.json categorization (re-open, awaiting NVIDIA)#34817
teknium1 merged 2 commits into
revert-34333-feat/nvidia-skills-tapfrom
feat/nvidia-skills-tap-reopen

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Re-opens the NVIDIA/skills tap integration + skills.sh.json categorization that was merged in #34333 and reverted in #34815. This PR is intentionally parked for review — do not merge until NVIDIA confirms (see Coordination).

NVIDIA/skills becomes a default trusted tap in the Hermes Skills Hub — discoverable, browsable, searchable, auto-updating through the same pipeline that serves OpenAI, Anthropic, and HuggingFace skills. On top of that, any GitHub tap that ships a repo-root skills.sh.json grouping sidecar gets real category labels in the Skills Hub instead of a tag-derived guess.

Base note: This PR is currently based on the revert branch (revert-34333-feat/nvidia-skills-tap) so the diff shows the work being re-added. Once revert #34815 lands on main, retarget this PR's base to main.

Changes

Tap integration

  • tools/skills_hub.pyNVIDIA/skills added to GitHubSource.DEFAULT_TAPS (path: skills/).
  • tools/skills_guard.pyNVIDIA/skills added to TRUSTED_REPOS (trust_level="trusted").
  • website/scripts/extract-skills.pyNVIDIA/skills"NVIDIA" in GITHUB_TAP_LABELS.
  • website/src/pages/skills/index.tsxNVIDIA pill in SOURCE_CONFIG (green #76b900), slotted after HuggingFace.
  • website/docs/user-guide/features/skills.md (+ zh-Hans) — NVIDIA added to default-taps and trusted-repos lists.

Category groupings via skills.sh.json (generic, not NVIDIA-specific)

  • tools/skills_hub.pyGitHubSource._get_skillsh_groupings() fetches+caches the repo-root skills.sh.json per repo; _parse_skillsh_groupings() flattens its groupings (title + skills[]) into {skill_name: title}; _list_skills_in_repo() stamps SkillMeta.extra["category"]; _meta_to_dict() serializes extra so the category survives the index cache round-trip.
  • website/scripts/extract-skills.py — prefers extra["category"] over the tag heuristic; exempts sidecar categories from the small-category → "Other" collapse.
  • website/docs/user-guide/features/skills.md — documents the mechanism with an example.

We standardized on the published skills.sh.json schema rather than NVIDIA's proprietary metadata.json, so any future tap adopting the standard gets categorization for free.

Validation

Result
tests/tools/test_skills_hub.py + test_skills_guard.py 205 passed (+12 new)
Live parse of NVIDIA's real skills.sh.json 43 mappings, 7 categories
Live _get_skillsh_groupings (caching + no-sidecar→None)
extract-skills.py consolidation (sidecar category survives; heuristic small-cats still collapse)

Coordination — DO NOT MERGE YET

Awaiting NVIDIA confirmation (@mhollinger / @moshe / @nikhilkswami) that skills.sh.json is the sidecar they want us standardized on. NVIDIA's open PR (NVIDIA/skills#90) ships two sidecars (metadata.json + skills.sh.json); this integration reads skills.sh.json. Their stated launch plan is domain-only filtering, which maps cleanly onto the skills.sh.json groupings. Hold the merge until they comment.

teknium1 added 2 commits May 29, 2026 12:28
NVIDIA/skills is now a default trusted tap in the Hermes Skills Hub —
discoverable, browsable, searchable, and auto-updating through the same
pipeline that already serves OpenAI, Anthropic, and HuggingFace skills.

Rebased onto current main.
A GitHub tap can ship a repo-root skills.sh.json (the published skills.sh
schema) declaring category groupings. The Skills Hub now reads it at index
time and uses each grouping title as the skill's category label, instead of
the tag-derived guess. Generic: any tap that ships the file gets real
categorization — NVIDIA's groupings (Inference AI, Decision Optimization,
GPU Development, etc.) flow through automatically.

- GitHubSource: _get_skillsh_groupings() fetches+caches the sidecar per repo;
  _parse_skillsh_groupings() flattens it to {skill_name: title};
  _list_skills_in_repo() stamps meta.extra['category']; _meta_to_dict now
  serializes extra so the category survives the index cache round-trip.
- extract-skills.py: prefers extra['category'] over the tag heuristic and
  exempts sidecar categories from the small-category to Other collapse.
- Docs + 12 tests.
@alt-glitch alt-glitch added type/feature New feature or request P2 Medium — degraded but workaround exists tool/skills Skills system (list, view, manage) labels May 29, 2026
@teknium1
teknium1 merged commit fe141a2 into revert-34333-feat/nvidia-skills-tap May 31, 2026
8 checks passed
@teknium1
teknium1 deleted the feat/nvidia-skills-tap-reopen branch May 31, 2026 16:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P2 Medium — degraded but workaround exists tool/skills Skills system (list, view, manage) type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants