Skills CLI Guide — Complete Terminal CRUD & Engine Manual
With SnippKit CLI (SNiX) v3, the
snix skill command group allows developers and CI/CD pipelines to Create, Discover, Install, Inspect, Update, and Remove AI agent skills directly from the terminal.Skills are installed into standardized agent directories (
.agents/skills, .cursor/rules, .windsurf/rules, .claude/skills) where modern coding assistants automatically discover and execute them.Command Overview
The canonical syntax for all skill operations is:
BASH
snix skill <action> [options]
(You can also use the plural alias
snix skills <action>.)| Action | Aliases | Description | Auth Required? |
|---|---|---|---|
| add | install, get | Download and install a skill into project or global agent directory | No (Public) |
| list | ls | List installed skills in workspace or remote cloud library (--remote) | No (Local) |
| view | show, info | Preview skill instructions and metadata in terminal without installing | No (Public) |
| search | N/A | Query public agent skills on SnippKit directory | No |
| remove | rm, delete | Remove an installed skill from workspace or global directory | No |
| init | N/A | Scaffold a standard local SKILL.md template | No |
| push | publish | Publish a local skill folder to SnippKit registry | Yes (snix auth login) |
Zero Authentication Required to Add Public Skills
Anyone can run
snix skill add <slug> or npx @snippkit/cli skill add <slug> in their terminal without an account or API key. Authentication is only required when managing private skills or publishing to the registry.1. Create & Publish Skills (Create)
Step 1: Scaffold a Local Skill Template (init)
Use
snix skill init to scaffold a compliant skill structure:BASH
snix skill init nextjs-performance
This creates
.agents/skills/nextjs-performance/SKILL.md with standard YAML frontmatter:MARKDOWN
--- name: nextjs-performance description: "Guidelines and patterns for optimizing Next.js App Router performance" version: 1.0.0 compatibility: ["antigravity", "cursor", "claude-code", "windsurf"] --- # Next.js Performance Optimization ## Core Rules: 1. Always prefer Server Components unless interactivity is strictly required. 2. Use dynamic imports with `next/dynamic` for heavy third-party components. 3. Keep layout files light to optimize streaming SSR.
Step 2: Publish to SnippKit Registry (push)
Authenticate your CLI once using
snix auth login, then publish your skill:BASH
# Publish publicly to the registry snix skill push .agents/skills/nextjs-performance --public --tags t # Publish as private encrypted skill snix skill push .agents/skills/nextjs-performance --private
2. Discover, View & List Skills (Read)
Search the Registry (search)
Search public skills by keyword:
BASH
snix skill search d
The CLI prints a colorized table showing matches, star counts, downloads, author namespaces, and compatibility flags.
Preview Instructions Without Installing (view)
Inspect any skill directly in your terminal without modifying any project files:
BASH
snix skill view red-white-theme-palette
List Installed Skills (list)
Inspect all skills currently installed in your workspace:
BASH
snix skill list
SNiX automatically scans your workspace for:
.agents/skills/**/SKILL.md(Google Antigravity & Universal Agents).cursor/rules/*.mdc(Cursor Composer).windsurf/rules/*.md(Windsurf Cascade).claude/skills/**/SKILL.md(Claude Code)
To list skills saved to your cloud account instead of local files, pass
--remote:BASH
snix skill list --remote
3. Install & Add Skills (Consume)
Basic Installation
Install any public skill with a single command:
BASH
snix skill add red-white-theme-palette
Or reference by author namespace:
BASH
snix skill add @unhuman/red-white-theme-palette
Targeting Specific Agent Environments (--target)
By default, SNiX auto-detects your workspace. You can also explicitly target a specific agent directory:
BASH
# Target Cursor Composer (.cursor/rules/<slug>.mdc) snix skill add red-white-theme-palette --target cursor # Target Windsurf Cascade (.windsurf/rules/<slug>.md) snix skill add red-white-theme-palette --target windsurf # Target Claude Code (.claude/skills/<slug>/SKILL.md) snix skill add red-white-theme-palette --target claude
Global Installation (--global, -g)
To make a skill available across all projects on your machine:
BASH
snix skill add red-white-theme-palette --global
This installs the skill globally into
~/.gemini/antigravity/skills/ where all agent sessions can access it.Non-Interactive / Force Overwrite (--force, --yes)
To overwrite an existing local skill without an interactive confirmation prompt:
BASH
snix skill add red-white-theme-palette --force
4. Update Skills (Update)
To pull the latest version of an upstream skill and update your local guidelines:
BASH
snix skill add red-white-theme-palette --force
To update a skill you authored on SnippKit:
- Bump the
versionfield insideSKILL.mdfrontmatter (e.g.1.0.0$\rightarrow$1.1.0). - Re-run
snix skill push:BASHsnix skill push .agents/skills/my-skill --public
5. Remove Skills (Delete)
To remove a skill from your local project:
BASH
snix skill remove red-white-theme-palette
To skip the interactive confirmation prompt:
BASH
snix skill remove red-white-theme-palette -y
To remove a globally installed skill:
BASH
snix skill remove red-white-theme-palette --global -y
Quick Reference Cheat Sheet
BASH
# --------------------------------------------------------- # SKILLS CRUD QUICK REFERENCE # --------------------------------------------------------- snix skill search e # 1. Search public directory snix skill view red-white-theme-palette # 2. Preview instructions in terminal snix skill add red-white-theme-palette # 3. Install into .agents/skills/ snix skill add theme --target cursor # 4. Install into .cursor/rules/ snix skill add theme --global # 5. Install globally for all projects snix skill list # 6. List all installed workspace skills snix skill init my-agent-skill # 7. Scaffold new local SKILL.md template snix skill push ./my-agent-skill -p # 8. Publish skill to SnippKit registry snix skill remove my-agent-skill -y # 9. Cleanly delete skill from workspace
Copyright © 2026 SnippKitUp to date