Config: Skill Conventions git:20260813.874484bA

Immutable. This exact content is served forever at /api/v1/blob/6ac1a295172fa31f.

---
name: "Skill: Conventions"
description: "{{ 𝚫𝚫𝚫 }} Jason's placement and model-tag conventions for creating or editing skills"
when_to_use: "Before creating or editing a skill — checking where it should live and how to tag its model in frontmatter."
# No model/effort override: reference content that loads inline — an override
# would downgrade the very session that's editing skills
disable-model-invocation: false # Claude must be able to load the conventions at the moment it's creating or editing a skill; read-only guidance needs no gate
---

# Skill creation conventions

- All skills live in `~/.claude/skills/` as `SKILL.md` files.
- Command skills (invoked explicitly) get `disable-model-invocation: true`; knowledge skills (always available for reference, never directly invoked) get `user-invocable: false`.
- Exception: a command skill may set `disable-model-invocation: false` when its `when_to_use` describes a moment Claude recognises before the user does (stale PR description, post-merge status drift, "add this to the roadmap" phrasing) **and** the skill contains its own approval gate before anything irreversible. The gate is the safety net; without one, keep it `true`.

## Where to create a skill

1. Always create in the project-local `.claude/skills/` directory unless explicitly told to create it globally.
2. Check for naming conflicts with personal-level skills (`~/.claude/skills/`) — personal scope shadows project scope.
3. Use the new frontmatter convention below when creating or editing skills; recognise the old convention when reading existing skills.

## Model-tag convention (new)

Runic letters in the YAML frontmatter `description` field signal which model the command uses:

| Runes | Model |
|---|---|
| `𝚫𝚫𝚫` | haiku |
| `ƔƔƔ` | sonnet |
| `𝛀𝛀𝛀` | opus |

Format: `description: "{{ ƔƔƔ }} Command description here"`

## Model-tag convention (old — recognise, don't write)

| Runes | Model |
|---|---|
| `ᚻᛕ` | haiku |
| `ᛇᚤ` | sonnet |
| `ᛜᚹ` | opus |
| `ᚨᛔ` | fable |

Format: `description: "{{ ᛇᚤ }} Command description here"`