Reusable AI agent skills — structured knowledge and workflows that any compatible agent (Hermes, OpenClaw, etc.) can load and follow.

skills/
├── README.md
├── <category>/
│   └── <skill-name>/
│       ├── SKILL.md              # Main skill file (YAML frontmatter + markdown body)
│       └── references/           # Optional supporting files
│           └── *.md

Each skill is a SKILL.md file with YAML frontmatter followed by a markdown body:

---
name: my-skill               # lowercase, hyphens, unique
description: One-line description of what this skill does.
version: 1
author: niean
license: MIT
tags: [tag1, tag2]
trigger: keyword phrases that indicate when to use this skill
---

# Skill Title

Markdown body with instructions, code examples, pitfalls, etc.

Copy or symlink skills into ~/.hermes/skills/:

# Copy a single skill
cp -r devops/aliyun-oss ~/.hermes/skills/devops/

# Or symlink the whole repo
ln -s /path/to/this/repo/devops/aliyun-oss ~/.hermes/skills/devops/aliyun-oss

Point your agent config to this repository. Skills are auto-discovered by scanning for SKILL.md files.

# List all skills
find . -name "SKILL.md" -exec dirname {} \; | sort

# Extract skill metadata
grep -A5 "^---" <category>/<skill>/SKILL.md | head -10

1. Create <category>/<skill-name>/SKILL.md
2. Include required YAML frontmatter (name, description)
3. Write clear instructions with code examples
4. Add a Pitfalls section for known issues
5. Add supporting files under references/ if needed
6. Update the Available Skills table in this README

MIT