oma-skill-creation
Create or revise OMA skills and their references. Use for skill routing, execution contracts, conditional loading, and authoring validation.
How do I install this agent skill?
npx skills add https://github.com/first-fluke/oh-my-agent --skill oma-skill-creationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a professional developer tool for authoring and validating AI agent instructions within the OMA (Oh My Agent) framework. It includes robust security guardrails, mandates explicit authorization for sensitive actions, and prohibits the use of real credentials in examples.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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.mdand 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: use the template and compare against the lean exemplars
oma-docs,oma-search,oma-security,oma-design, andoma-video; read one analogous skill for domain detail only. Most other skills still carry the full legacy shape (Entry, Scenes, Actions, tool and scope tables); do not copy it. - 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
- Read the target, its invoked resources, and relevant repository rules. Identify which entry points run independently and which content the runtime already injects.
- Select command-heavy, judgment-heavy, or reference-heavy behavior. Use the template's minimal skeleton and optional sections only where they add information.
- Write the canonical procedure once. Preserve exact command/output contracts, failure mechanisms, side effects, and harmful-action limits; remove generic restatements and redundant examples.
- Index resources once under References with load conditions. Keep source-adjacent evidence one hop from SKILL.md where possible.
- Run
oma skill lint --skill <name>andgit diff --check. If routing descriptions changed, runoma skill audit. Apply the content checks inresources/validation-checklist.mdthat automated lint does not cover. - Report the changes, checks, and remaining limits. A token-savings claim needs the measurement described in
resources/prompt-evaluation.md.
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
- Keep YAML
nameand a routing-gradedescription. Preserve the four top-level headings: Scheduling, Structural Flow, Logical Operations, References. - 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.
- Every other section is optional and must add distinct information, per the template's Optional detail rules. Do not repeat a procedure to fill the template.
- 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.
- Keep parsed output/schema examples. Do not prescribe decorative report layouts or add generic self-review loops; use runnable validators and explicit evidence requirements.
- Process bulk data through deterministic tools and return summaries/artifact paths instead of streaming raw data into context.
- 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:
oma skill eval --helpandoma skill optimize --help(when measuring held-out task utility); the guideweb/docs/guide/skill-eval.mdexists only in the oh-my-agent repository
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/first-fluke/oh-my-agent/oma-skill-creation">View oma-skill-creation on skillZs</a>