oma-skill-creation — скилл для Claude Code: что делает и установка
Скилл oma-skill-creation создаёт и редактирует скиллы OMA в формате SSL-lite для Claude Code и Codex. Включается при проектировании структуры .agents/skills/{name}/SKILL.md, настройке роутинга и проверке линтером.
MIT ★ 1 472 обновлён 2026-11-05
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает oma-skill-creation
Скилл стандартизирует создание и аудит инструкций .agents/skills/{name}/SKILL.md в формате SSL-lite. Он собирает документ по четырём обязательным разделам: Scheduling, Structural Flow, Logical Operations и References. Логика строится вокруг одного канонического пути выполнения, а лишние повторы шагов между разделами вычищаются.
Для работы используются встроенные шаблоны resources/ssl-lite-template.md и чек-лист приёмки resources/validation-checklist.md. Корректность синтаксиса и роутинга подтверждается валидаторами oma skill lint --skill <name>, git diff --check и oma skill audit. Все тяжёлые справочные данные скилл выносит во внешние ресурсы с условием загрузки, чтобы не раздувать контекст.
Тело файла SKILL.md ограничено 500 строками кода. Правило запрещает заявлять об экономии токенов без фактических замеров загруженного контекста. Скилл решает задачи структуры инструкций, поэтому не подходит для написания логики самого приложения или установки сторонних расширений.
Какие задачи решает
- структурировать файл
SKILL.mdпо четырём разделам формата SSL-lite - вынести редкие инструкции в условные ресурсы для экономии контекста
- проверить контракты исполнения и роутинг командами
oma skill lintиoma skill audit - убрать дублирование процедур между разделами скилла
Примеры запросов агенту
- Создай новый скилл для разбора логов в
.agents/skills/log-parser/SKILL.mdпо шаблону OMA - Проверь роутинг и контракты в
.agents/skills/deploy/SKILL.mdчерез oma skill lint - Сократи файл скилла до 500 строк и перенеси справочные таблицы в conditional resources
Как установить oma-skill-creation
1Через маркетплейс плагинов
/plugin marketplace add first-fluke/oh-my-agent/plugin install oma@oh-my-agentКоманда ставит плагин oma целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -a claude-code3Вручную: положить файлы
~/.claude/skills/oma-skill-creation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/oma-skill-creation/
1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -a codex2Вручную: положить файлы
.agents/skills/oma-skill-creation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -a cursor2Вручную: положить файлы
.cursor/skills/oma-skill-creation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install first-fluke/oh-my-agent skills/oma-skill-creation2Вручную: положить файлы
.github/skills/oma-skill-creation/SKILL.md1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -a gemini-cli2Командой платформы
gemini skills install https://github.com/first-fluke/oh-my-agent --path skills/oma-skill-creationВручную: положить файлы
.devin/skills/oma-skill-creation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об oma-skill-creation
Как установить oma-skill-creation в Claude Code?
Выполните в Claude Code команду /plugin marketplace add first-fluke/oh-my-agent, а затем /plugin install oma@oh-my-agent.
Каких ограничений по размеру требует скилл?
Тело файла SKILL.md должно укладываться в 500 строк. Объёмные инструкции и справочники выносятся в папку ресурсов и подключаются только по условию.
Для каких задач oma-skill-creation не подходит?
Скилл не предназначен для установки сторонних расширений, создания плагинов Codex, сбора общих требований к проекту и написания кода самого приложения.
Исходный текст
SKILL.md · MIT
---
name: oma-skill-creation
description: Create or revise OMA skills and their references. Use for skill
routing, execution contracts, conditional loading, and authoring validation.
---
# OMA Skill Authoring
## Scheduling
### Goal
Create or revise a usable OMA skill with clear routing, one execution path, domain-specific recovery, and proportionate context.
### Intent signature
- Create, update, audit, or normalize an OMA skill, its resources, or the SSL-lite format.
- Decide whether content belongs inline, in a conditional resource, or should be removed.
### When to use
- Authoring `.agents/skills/{name}/SKILL.md` and supporting resources.
- Reviewing skill routing, execution contracts, reference loading, or duplicated instructions.
### When NOT to use
- Installing third-party skills -> skill installer; creating a Codex plugin -> plugin tooling.
- Application implementation -> the owning specialist; project requirements -> `oma-pm`.
### Expected inputs
Skill purpose, triggers, boundaries, execution model, and existing commands/resources or user edits to preserve.
### Expected outputs
A four-section SKILL.md, only necessary supporting resources, and validation results with unresolved limitations.
### Dependencies
`resources/ssl-lite-template.md` for the skeleton and `resources/validation-checklist.md` for acceptance criteria. Use native file tools and available `oma skill` validators. Follow repository rules for source ownership and generated copies.
## Structural Flow
### Transitions
- New skill: compare 1–3 analogous skills, then use the template.
- Existing skill: preserve working domain detail and change only the requested scope.
- Repeated instructions: retain one authoritative location and a short reference where independently invoked entry points need it.
- Long or conditional detail: move to a named resource with a load condition. Do not move a duplicate merely to keep it elsewhere.
- Machine-checkable artifacts: declare structured `outputs:` as documented in the template.
### Failure and recovery
| Failure | Recovery |
|---|---|
| Overbroad routing | Narrow triggers and add a concrete When NOT to use cross-route |
| Vague execution | Add actual objects, paths, command flags, and evidence to the canonical path |
| Repeated procedure in multiple sections | Keep the canonical procedure; retain only distinct branches or state transitions elsewhere |
| Required tool unavailable | Use the documented fallback; otherwise report which result cannot be verified |
| Conflicting source and generated copies | Use the repository's generation flow; do not hand-edit protected definitions |
### Exit
A completed skill has valid structure, useful routing, executable steps, recoverable failures, valid references, and applicable validation evidence. Missing tools or unresolved assumptions must remain explicit.
## Logical Operations
### Canonical workflow path
1. Read the target, its invoked resources, and relevant repository rules. Identify which entry points run independently and which content the runtime already injects.
2. Select command-heavy, judgment-heavy, or reference-heavy behavior. Use the template's minimal skeleton and optional sections only where they add information.
3. Write the canonical procedure once. Preserve exact command/output contracts, failure mechanisms, side effects, and harmful-action limits; remove generic restatements and redundant examples.
4. Index resources once under References with load conditions. Keep source-adjacent evidence one hop from SKILL.md where possible.
5. Run `oma skill lint --skill <name>` and `git diff --check`. If routing descriptions changed, run `oma skill audit`. Apply the content checks in `resources/validation-checklist.md` that automated lint does not cover.
6. Report the changes, checks, and remaining limits. Do not claim reduced token usage merely from removing duplicate files; measure the context actually loaded when making that claim.
### Resource scope and effects
Skill work reads and may change local definitions/resources and generated vendor copies through the authorized repository flow. User data and credentials are not skill examples. Commits and publishing require the corresponding authorization.
### Guardrails
1. Keep YAML `name` and a routing-grade `description`. Preserve the four top-level headings: Scheduling, Structural Flow, Logical Operations, References.
2. Keep one canonical command/workflow path, an Intent signature, When to use/When NOT to use, input/output expectations, failure recovery, and relevant effects/guardrails. Section titles beyond these are optional when their information is already represented.
3. Entry, Scenes, Actions, and tool/scope tables must add distinct information. Do not repeat a procedure to fill the template.
4. Keep SKILL.md under 500 body lines. Load supporting resources conditionally; do not create README/changelog/install documents inside a skill merely to explain the skill.
5. Keep parsed output/schema examples. Do not prescribe decorative report layouts or add generic self-review loops; use runnable validators and explicit evidence requirements.
6. Process bulk data through deterministic tools and return summaries/artifact paths instead of streaming raw data into context.
7. Preserve unrelated user edits. Apply the shared execution policy to clarification, authorization, and verification.
## References
- Prompt behavior and model comparisons: `resources/prompt-evaluation.md` (routing, injection, authorization, or review-contract changes)
- Skeleton and optional sections: `resources/ssl-lite-template.md` (authoring or restructuring)
- Acceptance criteria: `resources/validation-checklist.md` (validation)
- Context loading: `references/_shared/core/context-loading.md` (resource/injection decisions)
- Quality principles: `references/_shared/core/quality-principles.md` (domain verification requirements)
- Eval fixtures: `web/docs/guide/skill-eval.md` (when measuring held-out task utility with `oma skill eval` or `oma skill optimize`)
© First Fluke · MIT · first-fluke/oh-my-agent