oma-skill-creation

Create and validate OMA skills using the SSL-lite Markdown structure.

1.3k|146|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/first-fluke/oh-my-agent --skill oma-skill-creation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oma-skill-creation
Source: https://github.com/first-fluke/oh-my-agent/tree/main/.agents/skills/oma-skill-creation
Command: npx skills add https://github.com/first-fluke/oh-my-agent --skill oma-skill-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Authoring agent skills without a consistent structure leads to poor routing, vague execution paths, and unmaintainable prompt files. This Skill standardizes how new OMA skills are created, converted, and audited so every SKILL.md is discoverable, executable, and validatable.

Core Features & Use Cases

  • SSL-lite Authoring: Generates SKILL.md files with the four required sections (Scheduling, Structural Flow, Logical Operations, References) plus a canonical command or workflow path.
  • Skill Conversion & Auditing: Normalizes existing skills into the standard format and checks routing boundaries, resource scope, guardrails, and failure-recovery coverage.
  • Validation Workflow: Runs oma skills lint and a structured checklist covering structure, cross-skill description collisions, and utility content dimensions.
  • Use Case: When adding a new capability to your agent harness, ask for a new skill and receive a complete .agents/skills/{name}/SKILL.md with trigger intents, boundaries, canonical execution path, and a validation report.

Quick Start

Create a new OMA skill named oma-data-export that exports query results to CSV, following the SSL-lite format.

Frequently Asked Questions about oma-skill-creation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new agent skill with SKILL.md?

Define the skill name, goal, trigger intents, and boundaries, then draft SKILL.md from the SSL-lite template with the four required sections. Add one canonical command or workflow path and validate with oma skills lint before finishing.

What is the SSL-lite skill format?

SSL-lite is a Markdown skill structure with four top-level sections: Scheduling, Structural Flow, Logical Operations, and References. It derives from the Scheduling-Structural-Logical skill representation and keeps skills readable, routable, and executable.

How do I validate a SKILL.md file structure?

Run oma skills lint --skill <name> to check frontmatter, top-level headings, canonical path, broken references, and boundaries. If the CLI is unavailable, use the grep and awk fallback checks in the validation checklist resource.

When should skill details go into resources instead of SKILL.md?

Move long examples, provider-specific variants, detailed protocols, and large checklists into resources/ files referenced from the References section. Keep routing, boundaries, inputs, outputs, flow, guardrails, and one canonical path inline in SKILL.md.

Why do two skills have overlapping trigger descriptions?

Overlapping descriptions cause routing ambiguity between adjacent skills. Run oma skills audit to detect similarity above 60 percent, then rewrite one description to highlight distinct triggers and add cross-routes in the When NOT to use section.