Сообщество навыков для Mini — многоразовых наборов инструкций, расширяющих возможности Claude специализированными рабочими процессами, знаниями в области и объединёнными ресурсами.

---

Что такое навык?

Навык — это каталог, содержащий файл SKILL.md (плюс необязательные объединённые ресурсы), который Claude загружает при обнаружении соответствующего пользовательского запроса. Навыки используют трёхуровневую систему загрузки:

1. Метаданные (name + description в фронтматтере) — всегда в контексте, используемые для триггера (~100 слов)
2. SKILL.md тело — загружается в контекст при срабатывании навыка (держите не менее 500 строк)
3. Пакетированные ресурсы — скрипты, ссылки и ассеты, загружаемые только по мере необходимости (неограниченный размер)

---

Структура каталога

Планировка репозитория

Именование каталога навыков

• Используйте маленький кебаб: my-skill-name
• Быть описательным, но лаконичным (идеально 2–4 слова)
• Использовать домен или действие как префикс, когда он помогает группировать навыки, связанные
• ✅ Хорошие: health-sleep-analysis, nano-banana, remote-dev-minis-app
• ❌ Избегать: MySkill, skill_for_doing_things, s1

---

SKILL.md формат

У каждого навыка обязательно есть SKILL.md с YAML-фронтматтерным блоком, за которым следуют инструкции Markdown.

MinisSkills

A community collection of skills for Minis — reusable instruction sets that extend Claude’s capabilities with specialized workflows, domain knowledge, and bundled resources.

---

What is a Skill?

A skill is a directory containing a SKILL.md file (plus optional bundled resources) that Claude loads when it detects a relevant user request. Skills use a three-level loading system:

1. Metadata (name + description in frontmatter) — always in context, used for triggering (~100 words)
2. SKILL.md body — loaded into context whenever the skill triggers (keep under 500 lines)
3. Bundled resources — scripts, references, and assets loaded only as needed (unlimited size)

---

Directory Structure

Repository Layout

MinisSkills/
├── README.md
└── /           # One directory per skill (see naming rules below)
    ├── SKILL.md            # Required
    ├── evals/              # Optional: test cases
    │   └── evals.json
    ├── scripts/            # Optional: executable helper scripts
    ├── references/         # Optional: reference docs loaded into context as needed
    └── assets/             # Optional: templates, icons, fonts used in output

Skill Directory Naming

• Use lowercase kebab-case: my-skill-name
• Be descriptive but concise (2–4 words is ideal)
• Use the domain or action as a prefix when it helps group related skills
• ✅ Good: health-sleep-analysis, nano-banana, remote-dev-minis-app
• ❌ Avoid: MySkill, skill_for_doing_things, s1

---

SKILL.md Format

Every skill must have a SKILL.md with a YAML frontmatter block followed by Markdown instructions.

Frontmatter (Required)

---
name: skill-name
description: >
  One or two sentences describing what the skill does and — crucially — when
  Claude should trigger it. Include specific user phrases, contexts, and
  keywords that signal this skill is needed. Be slightly "pushy": list
  edge cases and near-miss scenarios where this skill should still win.
---

Why the description matters: The description field is the primary trigger mechanism. Claude reads the skill name + description to decide whether to load the skill. A vague description leads to undertriggering. A good description covers both what the skill does and when to use it, with concrete phrases a real user might say.

Optional Frontmatter Fields

---
name: skill-name
description: ...
compatibility: Python 3.10+, requires ffmpeg  # tools/deps needed, if any
---

Full Anatomy

skill-name/
├── SKILL.md
│   ├── YAML frontmatter    ← name, description (required); compatibility (optional)
│   └── Markdown body       ← instructions, examples, output formats, workflows
└── Bundled Resources (optional)
    ├── scripts/            ← deterministic/repetitive tasks; Claude runs without loading