Skip to content

skill_view resolves by directory name but skills_list displays frontmatter name — mismatch causes 'not found' #17914

@hahahaha992009

Description

@hahahaha992009

skill_view resolves by directory name but skills_list displays frontmatter name — mismatch causes "not found"

Description

When a skill's directory name differs from its YAML frontmatter name, loading it with skill_view fails with "Skill not found" when using the name shown in skills_list.

Repro

# Skill stored at: ~/.hermes/skills/darwin/SKILL.md
# Frontmatter: name: darwin-skill

hermes skills list
# Shows: darwin-skill | Darwin Skill (达尔文.skill): ...

Then in-session:

skill_view('darwin-skill')   # ❌ Skill 'darwin-skill' not found
skill_view('darwin')         # ✅ works

Root cause

  • skills_list displays the frontmatter name field (darwin-skill)
  • skill_view resolves by directory name (darwin/)
  • These two values can diverge (e.g., darwin-skill vs darwin), creating a confusing UX where the user copies the name from the list and it doesn't work

Expected behavior

skill_view should accept both the directory name and the frontmatter name, or skills_list should display the directory name (the canonical identifier).

Environment

  • Hermes Agent latest
  • macOS
  • Skill: darwin-skill (directory darwin/, frontmatter name: darwin-skill)

Labels

bug skills

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium — degraded but workaround existssweeper:implemented-on-mainSweeper: behavior already present on current maintool/skillsSkills system (list, view, manage)type/bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions