new-skill

Installation
SKILL.md

Creating a SKILL.md

A skill is a markdown file that teaches an AI agent a specific workflow, tool, or pattern. Skills are loaded into context when the agent recognizes a task that matches the skill's description.

File location

Place the skill in a top-level skills/ folder at the repository root:

skills/<skill-name>/SKILL.md

For example: skills/critique/SKILL.md, skills/errore/SKILL.md.

Do not put skills inside package folders like cli/skills/, website/skills/, or packages/foo/skills/ unless the repository intentionally syncs or mirrors them there for internal tooling. The canonical repository layout for a skill you are creating is always the root-level skills/ directory.

The folder name should match the skill name in kebab-case. Each skill gets its own folder so it can include companion files if needed (scripts, templates, references).

For personal skills that follow you across all repos and are not meant for distribution in a GitHub repository, place them in:

Related skills
Installs
1
Repository
remorses/kimaki
GitHub Stars
1.1K
First Seen
4 days ago