---
name: skill
description: Manage Omagy plugin skills - list, search, show, validate, add, edit, remove, and sync
argument-hint: "<list|show|search|validate|add|edit|remove|sync> [args]"
---

# /omagy:skill

Use this skill to inspect and maintain Omagy's plugin-scoped skills.

This is the Omagy adaptation of OMX skill management. It manages this repo's
canonical `skills/` tree and the plugin mirror under `plugin/skills/`; it does
not edit Codex user skills or `.codex/skills`.

## Commands

```bash
omagy skill list --json
omagy skill show ai-slop-cleaner --json
omagy skill search cleanup --json
omagy skill validate --json
omagy skill sync --json
```

## Mutating Commands

Use structured input for mutations:

```bash
omagy skill add --input '{"name":"custom-skill","description":"Do custom work","triggers":["custom"],"argumentHint":"<target>"}' --json
omagy skill edit custom-skill --input '{"description":"Updated description","triggers":["custom","update"]}' --json
omagy skill remove custom-skill --yes --json
```

Rules:

- Skill names must be lowercase kebab-case.
- `add` writes both `skills/<name>/SKILL.md` and
  `plugin/skills/<name>/SKILL.md`.
- `edit` defaults to the canonical source skill and mirrors the change to the
  plugin skill when it exists.
- `remove` requires `--yes` or `{"yes":true}`.
- `sync` copies canonical source skills into the plugin mirror.
- `validate` checks source/plugin name parity, content parity, and required
  frontmatter.

## Workflow

1. Use `omagy skill list --json` to see source, plugin, and installed scopes.
2. Use `omagy skill search <query> --json` before adding a new skill.
3. Use `omagy skill add` or `edit` with structured JSON.
4. Run `omagy skill validate --json`.
5. Run `omagy setup` when the installed Antigravity plugin should receive the
   refreshed skill surface. Maintainers can run `npm run verify-plugin` when
   plugin packaging consistency matters.