Skip to content

fix(skills): add agentskills.io spec compliance for tags/platforms frontmatter#30105

Closed
alaamohanad169-ship-it wants to merge 1 commit into
NousResearch:mainfrom
alaamohanad169-ship-it:fix/skills-spec-compliance
Closed

fix(skills): add agentskills.io spec compliance for tags/platforms frontmatter#30105
alaamohanad169-ship-it wants to merge 1 commit into
NousResearch:mainfrom
alaamohanad169-ship-it:fix/skills-spec-compliance

Conversation

@alaamohanad169-ship-it

Copy link
Copy Markdown
Contributor

Summary

Makes Hermes skill loading backward-compatible with the agentskills.io spec (adopted by Anthropic, NVIDIA, 40+ clients). Skills with tags and platforms under metadata: now load correctly alongside the existing top-level format.

Problem

Issue #30080: The agentskills.io spec places agent-specific fields under metadata: instead of top-level. NVIDIA's 155 verified skills use metadata.tags and metadata.platforms. Hermes only reads top-level tags/platforms, so these spec-compliant skills are silently ignored.

Fix

3 loader sites updated to check both locations:

File Field Precedence
agent/prompt_builder.py:929 platforms top-level → metadata.platforms
agent/skill_utils.py:140 platforms top-level → metadata.platforms
tools/skills_tool.py:1277 tags metadata.hermes.tags → top-level → metadata.tags
tools/skills_tool.py:1278 related_skills metadata.hermes.related_skills → top-level → metadata.related_skills

All changes are single-line backward-compatible fallbacks. Existing skills with top-level fields are unaffected.

Testing

  • Load a skill with metadata.platforms instead of top-level
  • Load a skill with metadata.tags instead of top-level
  • Verify existing skills (top-level format) still work
  • Verify NVIDIA published skills load correctly

Fixes #30080

@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) labels May 21, 2026
@alaamohanad169-ship-it

Copy link
Copy Markdown
Contributor Author

Closing this PR — it was stale (far behind upstream main with test conflicts). Superseded by #30978 which is the clean rebased version.

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

Labels

P3 Low — cosmetic, nice to have 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.

Strict agentskills.io spec compliance: move tags/platforms under metadata in skill frontmatter

2 participants