Multi Tool Compatibility

Multi-Tool Compatibility

Every skill in awesome-skills is designed to work across multiple agent runtimes from a single canonical SKILL.md.

---

Runtime Adaptors

Runtime	Loads	Notes
Hermes Agent	SKILL.md → ~/.hermes/skills/	Native format
Claude Code / Claude.ai	SKILL.md / CLAUDE.md	CLAUDE.md is a thin adaptor
Cursor	.cursor/rules/*.mdc	Rule files in .cursor/rules/
Windsurf	.windsurfrules / skills/*.md	Project-level rules
OpenClaw / Roo / Cline / AGY	SKILL.md / manifest.json	manifest.json for discovery

---

How It Works

1. Canonical source: SKILL.md in Hermes format
2. Thin adaptors: runtime-specific files that reference or translate — never duplicate logic
3. Templates: templates/ provides starter kits for each runtime

---

Installing into a Specific Runtime

Hermes Agent

cp -r skills/<category>/<skill> ~/.hermes/skills/<category>/

Claude Code

# Copy the SKILL.md or CLAUDE.md
cp skills/<category>/<skill>/SKILL.md .claude/skills/<skill>.md

Cursor

# Convert SKILL.md to .cursor/rules/<skill>.mdc
# Use templates/agent-template/ as reference

Windsurf

# Add to .windsurfrules
# Use templates/agent-template/ as reference

---

Contributing Multi-Tool Skills

When submitting a new skill:

1. Follow templates/skill-template/ for the canonical SKILL.md
2. Include thin adaptors if you can (e.g., CLAUDE.md, manifest.json)
3. Test in at least one runtime
4. Document any runtime-specific quirks in references/

See Contributing Guide for the full workflow.