# Skills Creator

> Template and notes when creating or updating SKILL.md files under skills/

- Skill: `nazozokc/skills-creator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nazozokc/skills-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nazozokc/skills-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nazozokc (https://skillmd.com/u/nazozokc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nazozokc/skills-creator

---


# Skill Creation Guidelines

## When to Use

- When creating a new `skills/*/SKILL.md`
- When improving or updating an existing skill

## Basic SKILL.md Structure

```markdown
---
name: <skill name (match directory name)>
description: <one-line summary of when and why to use it>
---

# <Title>

## When to Use

- ...

## Basic Rules

- ...

## Notes

- ...
```

## Writing Rules

- **Write in English**: All skills in this dotfiles repo use English
- **Use bullet points**: No long prose — keep it concise
- **Always write "When to Use"**: Critical for agents to determine trigger conditions
- **Be explicit about prohibitions**: Clearly state "don't do X" or "X is forbidden"
- **Include examples**: Commands and formats should have concrete examples

## What Not to Do

- Leave `description` empty (skill will never be triggered)
- Use vague expressions ("might", "depending on the case")
- Pack multiple roles into one skill
- Duplicate content from other skills (use `see ../other/SKILL.md` instead)

## How to Write description

### Good Examples

- `When performing Git commits and pushes`
- `When creating a PR with gh cli`
- `When generating Nix code, editing flakes, or operating home-manager`

### Bad Examples

- `git stuff` (too abstract)
- `information about commits` (not a conditional statement)

## Registering in CLAUDE.md

After creating a new skill, add an entry to `~/ghq/github.com/nazozokc/dotfiles/agents/CLAUDE.md`:

```markdown
## ./skills/<name>/SKILL.md

Always refer to this skill when <use case>.
```

## File Layout

```
skills/
└── <name>/
    └── SKILL.md   ← This is all you need (keep it simple)
```