# Oma Skill Creation

Create or revise OMA skills and their references.

- Repository: https://github.com/first-fluke/oh-my-agent (1356 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -g -a claude-code -y`
Codex: `npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -g -a codex -y`
Cursor: `npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -g -a cursor -y`
Gemini CLI: `npx skills add first-fluke/oh-my-agent --skill oma-skill-creation -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add first-fluke/oh-my-agent`

## Description

Create or revise OMA skills and their references. Use for skill routing, execution contracts, conditional loading, and authoring validation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

The rest: https://github.com/first-fluke/oh-my-agent/blob/HEAD/.agents/skills/oma-skill-creation/SKILL.md