skill

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

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:

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.