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>.)
ActionAliasesDescriptionAuth Required?
addinstall, getDownload and install a skill into project or global agent directoryNo (Public)
listlsList installed skills in workspace or remote cloud library (--remote)No (Local)
viewshow, infoPreview skill instructions and metadata in terminal without installingNo (Public)
searchN/AQuery public agent skills on SnippKit directoryNo
removerm, deleteRemove an installed skill from workspace or global directoryNo
initN/AScaffold a standard local SKILL.md templateNo
pushpublishPublish a local skill folder to SnippKit registryYes (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 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:
  1. Bump the version field inside SKILL.md frontmatter (e.g. 1.0.0 $\rightarrow$ 1.1.0).
  2. Re-run snix skill push:
    BASH
    snix 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