writing-skill-hooks

Files (1)

• SKILL.md

SKILL.md (first lines)

# writing-skill-hooks

A skill hook instructs the agent to load it whenever a target skill is invoked, directly or through another skill. This relies on agent instructions, not runtime events.

## Description format

Use exactly this format, replacing `<target-skill>` with the target skill's name:

```yaml
description: Always use when <target-skill> skill is invoked.
```

Keep only this invocation instruction in the description.

## Writing a hook

1. Read the target skill and identify the behavior to add or override. Leave the target file unchanged.
2. Create `<hook-name>/SKILL.md` in the repository's skill directory. Set `name` to the directory name and use the description format above. Omit `disable-model-invocation` so the agent can discover the hook.
3. In the body, explicitly define the added or overridden rules. Preserve the remaining workflow by reference. Include conditions and fallbacks for optional tools or capabilities.

From m3nowak/skills, MIT.

More from m3nowak/skills