skill

name	skill
description	Manage OMA skills — list, add, remove, search, and edit skills
argument-hint	<action> [skill-name]
allowed-tools	["Read","Glob","Grep","Bash","Edit","Write"]
model	sonnet4.6

[EXECUTING /oma:skill — DO NOT SUMMARIZE. EXECUTE THE STEPS BELOW IMMEDIATELY.]

/oma:skill

Purpose: Manage OMA skills — list available skills, add new ones, remove, search, and edit.

Usage:

• /oma:skill list — List all available skills
• /oma:skill search <term> — Search skills by keyword
• /oma:skill add <name> — Add a skill from registry
• /oma:skill remove <name> — Remove a skill (see Remove vs Delete note below)
• /oma:skill edit <name> — Edit a skill's content
• /oma:skill setup <scope> — Set up skills for a given scope (user, project, or plugin)
• /oma:skill sync [source] — Sync skills from remote sources

Examples:

• /oma:skill list
• /oma:skill search "planning"
• /oma:skill add ralph
• /oma:skill remove unused-skill
• /oma:skill edit my-custom-skill
• /oma:skill setup user
• /oma:skill setup project
• /oma:skill sync
• /oma:skill sync https://github.com/user/repo/tree/main/skills/my-skill

---

How It Works

Skill Management

List Skills:

• Shows all installed skills with descriptions
• Indicates which are built-in vs. custom

Search:

• Searches skill names and descriptions
• Supports fuzzy matching

Add:

• Fetches from OMC skill registry or GitHub URL
• Installs to plugins/oma/skills/ or project .skills/
• Remote installation: /oma:skill sync https://github.com/user/repo/tree/main/skills/skill-name

Sync (remote install):

• /oma:skill sync — sync all skills from configured remote sources
• /oma:skill sync <url> — install a skill directly from a GitHub URL
• Supports GitHub tree URLs (fetches the SKILL.md directly)
• Example: /oma:skill sync https://github.com/user/repo/tree/main/skills/my-skill

Setup:

• /oma:skill setup user — Initializes the user-level skills directory (~/.augment/plugins/marketplaces/oh-my-auggie/plugins/oma/skills-learned/)
• /oma:skill setup project — Initializes the project-level skills directory (.oma/skills/)
• /oma:skill setup plugin — Initializes the plugin-internal skills directory (plugins/oma/skills/)
• Each scope has different precedence: project > user > built-in (plugin-internal)

Remove:

• Deletes skill file from the target location
• Confirms before deletion
• Note: Use remove only. delete is not a supported subcommand alias.

Edit:

• Opens skill file in edit mode
• Validates YAML frontmatter on save

Skill Structure

Skills are .md files with YAML frontmatter:

---
name: skill-name
description: What the skill does
trigger: "keyword"  # optional auto-invoke
model: sonnet4.6    # recommended model
---
[skill content]

Skill Registry

Built-in skills (cannot be removed):

• autopilot, ralph, ultrawork, team, plan, ralplan
• ccg, ultraqa, ask, note, skill
• doctor, setup, mcp-setup, hud, trace
• release, session, visual-verdict, learner
• writer-memory, notifications, science, research
• deepinit, interview, deslop

Delegation Requirement (OMA Orchestration Mode)

When OMA orchestration mode is active, write operations MUST delegate to executor:

• /oma:skill add <name> — delegate to executor
• /oma:skill remove <name> — delegate to executor
• /oma:skill edit <name> — delegate to executor

Read-only operations (list, search, info) may proceed directly.

Constraints

• Custom skills stored in project .skills/ take precedence
• Skill names must be unique
• Removing built-in skills shows warning but allows