📝 Skill Authoring Meta-Skill

Complete guide to creating exhaustive, high-quality skills for any AI agent. Based on the workflow used to create pixel-art-texturing-bible and procedural-monster-movement.

What is it

A meta-skill that teaches how to create complete skills: research, quality verification, structuring, multi-agent support, multi-engine support, and GitHub publication.

Compatible Agents

• Hermes Agent — hermes skills install or /skill skill-authoring
• Claude Code / Claude Desktop — paste into CLAUDE.md
• ChatGPT / GPT — paste into custom instructions
• Cursor, Windsurf, Cline, Continue, Aider, Codex — load as project context

Installation

Via Hermes CLI

hermes skills install https://raw.githubusercontent.com/ramonsamagaio/hermes-skills/main/skill-authoring/SKILL.md

Manual

git clone https://github.com/ramonsamagaio/hermes-skills.git
cp -r hermes-skills/skill-authoring ~/.hermes/skills/skill-authoring

For Claude Code

Add to your project's CLAUDE.md:

# Skill Authoring
When creating skills, follow the skill-authoring meta-skill:
- Read SKILL.md for complete workflow
- Use references/ for specific techniques
- Always research before writing
- Target 9/10 in all quality categories

For ChatGPT / GPT

Paste the SKILL.md content into your custom instructions. The agent will follow the workflow when asked to create skills.

For Cursor / Windsurf / Cline

Add to .cursorrules, .windsurf/rules.md, or .cline/rules:

# Skill Authoring
When creating documentation or skills, use the skill-authoring meta-skill in this project.
Read SKILL.md for the complete workflow before starting any skill creation.

Structure

skill-authoring/
├── SKILL.md                          # Complete guide (read first)
└── references/
    └── (supporting files)

How to Use

1. Load the skill

Hermes:

/skill skill-authoring

Claude/GPT/Cursor: Paste SKILL.md into context or reference it in your prompt.

Any agent: "Use the skill-authoring meta-skill to create a skill about X"

2. Follow the workflow

1. Define scope — what, for which agents, for which engines
2. Research — search GitHub, YouTube, Reddit, docs
3. Structure — SKILL.md + references/
4. Write — start with SKILL.md, then references
5. Self-evaluate — 9/10 in all categories
6. Publish — GitHub with description and topics
7. Maintain — update when needed

Key Principles

Principle	Description
Research first	Never write before researching
9/10 minimum	Every category must be 9/10 or higher
Multi-agent	Works with Hermes, Claude, GPT, Cursor, etc.
Multi-engine	Unity, Godot, Unreal, custom
Self-contained	Reader can execute without external help
Verified	Code works, formulas are correct, references are real

Quality Checklist

• Researched before writing
• All techniques are real (not experimental)
• Code tested/verified
• Works in Unity? Godot? Unreal?
• Works with Hermes? Claude? GPT? Cursor?
• Formulas documented
• ASCII diagrams included
• Anti-patterns documented
• Quick-reference created
• Self-evaluation: 9/10 in everything
• Public README in English
• Instructions per agent included
• Repo published with description and topics
• Semantic versioning

Related Skills

• Pixel Art Texturing Bible — example of a complete skill
• Procedural Monster Movement — example of a complete skill

License

MIT