Meta · bundled with dot-skills

Creating Skills

creating-skills

One of the two meta-skills bundled with dot-skills. Point an agent at it whenever someone says 'make this a skill' - it covers kebab-case naming, the SKILL.md frontmatter schema, writing a description concrete enough that agents actually load the skill at the right time, declaring env and CLI dependencies, and linking the finished skill out to every agent.

What it does

Guides naming and folder structure for a new .skills/ entry
Covers the SKILL.md frontmatter schema, including dependencies
Generates a stable UUID id plus author and repo attribution
Focuses descriptions on concrete trigger phrases so skills fire reliably
Finishes by linking the skill into every configured agent

Frontmatter it produces

The SKILL.md frontmatter shape this skill teaches an agent to write.

yaml

---
name: my-skill
id: 56824965-a4de-4b74-bf8d-5d04b598de77
author: Your Name
repo: https://github.com/your-name/your-skills-repo
description: >-
  What it does, and when an agent should reach for it. Be concrete
  about trigger phrases.
dependencies:
  - type: env
    name: OPENAI_API_KEY
    required: true
    instructions: Create a key and add it to your .env file.
---

Example prompt

“Turn this prompt I keep reusing into a skill.”

Install

npx dot-skills add levi-putna/twistedbrackets.com/creating-skills