Skip to content

skills.sh compatibility

skills.sh compatibility refers to the technical and structural adherence required for a Claude Code Skill to be correctly recognized, installed, and executed within the Hermes ecosystem (commonly associated with the skills.sh command-line interface)^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md].

While various projects (such as nuwa-skill or colleague-skill) may generate useful agents or cognitive frameworks, native compatibility ensures that the Skill integrates seamlessly with the platform's features, such as installation via npx skills add and the "Use when..." triggering mechanism^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md].

Standard Specification

A fully compatible Skill adheres to a specific directory structure and metadata format. The Hermes standard typically expects the following anatomy^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md]:

  • Frontmatter: The SKILL.md file must contain standard YAML metadata. This includes name and a description formatted with specific trigger phrases (e.g., "Use when...").
  • Directory Structure: The repository should be organized into specific folders:
    • SKILL.md: The main entry point and definition file.
    • references/: Contains supporting documentation or context.
    • templates/: (Optional) Used for prompt generation or structured outputs.
    • scripts/: (Optional) Contains executable logic or automation scripts.

Adapting Non-Native Skills

Tools designed to generate Skills for Claude Code may produce outputs that are functionally valid for the AI but structurally different from the Hermes standard. For example, the nuwa-skill framework generates a "Meta-Skill" for distilling cognitive frameworks, which uses a simpler metadata format and omits the templates/ and scripts/ directories by default^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md].

To achieve skills.sh compatibility with these generated tools, an adaptation process is usually required. This typically involves^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md]: 1. Updating Frontmatter: Converting simple metadata to the standard YAML format required by Hermes. 2. Restructuring: Adding the missing standard directories (templates/, scripts/) even if empty. 3. Content Alignment: Ensuring the content within SKILL.md aligns with a "workflow" style if expected by the platform, rather than just a "cognitive framework" style.

This adaptation process is generally considered low-cost; for instance, adapting a nuwa-skill output to the Hermes format is estimated to take approximately 15–30 minutes, as the core content (Markdown) remains fully compatible^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md].

Installation

Compatible Skills can be installed directly via the command line interface using the platform's package manager syntax^[001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md].

Example Syntax: 

npx skills add [namespace]/[skill-name]

  • nuwa-skill: A tool for generating cognitive framework Skills that requires adaptation for full Hermes compatibility.
  • [[Claude Code]]

Sources

  • 001-TODO__nuwa-skill_-_Claude_Code_认知框架提取工具.md