ctaxnagomi Create Hermes Skill
Author new SKILL.md files for Hermes Agent with built-in dictionary correction. Validates frontmatter, corrects typos, and ensures your skill follows Hermes standards.
When to Use
- Creating a new skill from scratch
- Want to ensure your SKILL.md is valid
- Need help with Hermes skill format
- Correcting common mistakes in skill files
Prerequisites
- Hermes Agent installed (v0.12.0+)
- Text editor or terminal access
- Basic understanding of YAML frontmatter
- Markdown knowledge
Procedure
Step 1: Gather Requirements
- What does the skill do?
- When should it trigger?
- What tools does it need?
- What are the step-by-step instructions?
Step 2: Use the Dictionary
Before writing, apply these corrections to your input:
Common Typos:
| Wrong | Correct |
|---|---|
| skillname | skill-name |
| descriptionn | description |
| triger | trigger |
| prerequisits | prerequisites |
| verifycation | verification |
| procedur | procedure |
| pitfals | pitfalls |
| funciton | function |
| paramter | parameter |
| retrun | return |
| asyncronous | asynchronous |
| dependancy | dependency |
| inheritence | inheritance |
| recieve | receive |
| occurances | occurrences |
| consistant | consistent |
| seperate | separate |
| neccessary | necessary |
| accomodate | accommodate |
| acheive | achieve |
| aquire | acquire |
| arguement | argument |
| assasination | assassination |
| basicly | basically |
| believe | believe |
| calender | calendar |
| catagory | category |
| commited | committed |
| concensus | consensus |
| definately | definitely |
| desparate | desperate |
| disapear | disappear |
| embarass | embarrass |
| existance | existence |
| familar | familiar |
| finaly | finally |
| follwing | following |
| foriegn | foreign |
| giveing | giving |
| grammer | grammar |
| harrassment | harassment |
| independednt | independent |
| interupt | interrupt |
| knowlege | knowledge |
| libary | library |
| liscense | license |
| maintenence | maintenance |
| manageing | managing |
| milisecond | millisecond |
| neigbor | neighbor |
| noticable | noticeable |
| occured | occurred |
| perfomance | performance |
| persistant | persistent |
| posession | possession |
| preceed | precede |
| priviledge | privilege |
| probaly | probably |
| promiss | promise |
| psuedo | pseudo |
| reciept | receipt |
| refered | referred |
| relevent | relevant |
| rember | remember |
| repitition | repetition |
| requirment | requirement |
| rescind | rescind |
| responsability | responsibility |
| restaraunt | restaurant |
| seach | search |
| similarily | similarly |
| sincere | sincere |
| specifc | specific |
| successfull | successful |
| supercede | supersede |
| surprize | surprise |
| temperture | temperature |
| their | their/there/they're |
| there | there/their/they're |
| threshold | threshold |
| tommorow | tomorrow |
| tongiht | tonight |
| truely | truly |
| unfortunatly | unfortunately |
| untill | until |
| wierd | weird |
Grammar Rules:
| Wrong | Correct |
|---|---|
| its | it's (when meaning "it is") |
| your | you're (when meaning "you are") |
| theyre | they're |
| could of | could have |
| should of | should have |
| would of | would have |
| alot | a lot |
| noone | no one |
| eachother | each other |
Step 3: Write the SKILL.md
Follow this template:
---
name: my-skill-name
description: "Brief description (max 60 chars)"
version: 1.0.0
author: Your Name
license: MIT
platforms: [linux, macos, windows]
metadata:
hermes:
tags: [category, keyword, keyword]
---
# Skill Title
Brief intro.
## When to Use
Trigger conditions.
## Procedure
1. Step one
2. Step two
## Pitfalls
- Known failure modes
## Verification
How to confirm it worked.
Step 4: Validate
- Frontmatter is valid YAML
- Description is under 60 characters
- Name uses lowercase with hyphens
- No typos from dictionary above
- All sections present (When to Use, Procedure, Pitfalls, Verification)
Step 5: Test
- Save to
~/.hermes/skills/<category>/<skill-name>/SKILL.md - Run
/skillsin Hermes to confirm it appears - Trigger the skill and verify behavior
Pitfalls
- Missing frontmatter fields
- Description too long (over 60 chars)
- No trigger conditions
- Skipping verification section
- Not testing before publishing
Verification
- Skill appears in
/skillslist - Skill triggers correctly
- All steps work as documented
- No typos in final output
How to use?
1. Download
Go to the AGENT KD SKILL gallery and find this skill card. Click Download to save the SKILL.md file.
2. Install
Copy the downloaded SKILL.md into your agent's skills directory:
| Agent | Path |
|---|---|
| Hermes | ~/.hermes/skills/hermes/create-hermes-skill/SKILL.md |
| opencode | ~/.config/opencode/skills/create-hermes-skill/SKILL.md |
| Claude Code | ~/.claude/skills/create-hermes-skill/SKILL.md |
3. Use
Restart your agent session. The skill will auto-load when you want to create a new skill.
4. Verify
Ask your agent to help create a skill. If it uses the dictionary and validates input, you're all set.