manage-skillslisted

# Manage User Skills Use Agent Bridge's existing shared-skill projection. Do not create another skill registry or provider-specific copy workflow. ## Ownership - Bundled Agent Bridge Skills live in the active release's `skills/` directory and are managed by the release. - User-authored Skills live canonically at `~/.agents/skills/<skill-name>/SKILL.md` (`SHARED_MEMORY_HOME` takes precedence over `HOME` when configured). - User Skills project as symlinks into native provider directories so the canonical Skill remains authoritative: - Codex: `~/.codex/skills/<skill-name>` - Claude: `~/.claude/skills/<skill-name>` - Antigravity/Agy: `~/.gemini/antigravity-cli/skills/<skill-name>` - Cursor is excluded from that universal projection. The canonical Cursor-native path is `~/.cursor/skills/<skill-name>/SKILL.md` and is created only when explicitly requested. - Do not edit a bundled Skill when the user intends to create their own Skill. ## Create or save 1. Choose a unique lowercase kebab-case name, 1-64 characters. 2. From the active Agent Bridge release, run `npm run skills -- list` and reject a name that collides with a bundled Skill. 3. Create `~/.agents/skills/<name>/SKILL.md` with standards-compatible frontmatter: ```markdown --- name: my-skill description: Use when ... --- # My Skill ``` 4. Keep the description non-empty and at most 1024 characters. `skill.json` is optional legacy metadata; do not create it unless a concrete compatibility need exists. 5. Project/r