Installation Guide

Quick Installation

Homebrew (macOS & Linux)

brew tap leodinhsa/skillops
brew install skillops

Manual Installation (from source)

# Build from source
go build -o skillops main.go

# Move to PATH
sudo mv skillops /usr/local/bin/

# Verify installation
skillops --help

Verification

After installation, verify that SkillOps is working correctly:

# View help and available commands
skillops --help

# Check if skillops is in your PATH
which skillops

Configuration

SkillOps stores its configuration in ~/.skillops/config/agentics.yaml. The configuration file is created automatically on first run.

Configuration File Location

• All Config: ~/.skillops/config/agentics.yaml

Skill Identification

Skill folders are identified by the presence of a SKILL.md file in the repository root.

Troubleshooting

Permission Denied

If you encounter permission issues:

# Make sure the binary is executable
chmod +x /usr/local/bin/skillops

# Check if /usr/local/bin is in your PATH
echo $PATH

Command Not Found

If skillops command is not found:

# Add to your shell profile (.bashrc, .zshrc, etc.)
export PATH="/usr/local/bin:$PATH"

# Reload your shell
source ~/.bashrc  # or ~/.zshrc

Next Steps

Once installed, you can:

1. Pull your first skill
2. Configure agentic IDEs
3. Start managing skills

For more detailed usage instructions, see the Commands Reference.

Commands Reference

Overview

SkillOps provides a comprehensive set of commands for managing AI agent skills across multiple Agentic IDEs (Claude, Antigravity, OpenCode, etc.). All commands follow a consistent pattern and provide rich interactive terminal experiences.

Project Configuration

skillops agentic

Open a checklist TUI to enable/disable Agentic IDE environments in your project root.

skillops agentic

Features:

• Interactive checklist interface for managing multiple IDEs
• Real-time status updates
• Bulk enable/disable operations
• Confirmation prompts for safety

Example:

cd /path/to/your/project
skillops agentic
# Opens TUI to select which IDEs to enable in this project

skillops agentic manage <name>

Interactively manage skills or remove the environment for a specific agentic IDE.

# Manage Claude IDE skills
skillops agentic manage claude

# Manage Windsurf IDE skills
skillops agentic manage windsurf

Features:

• Toggle individual skills on/off
• View skill details and descriptions
• Remove all skills for the IDE
• Interactive TUI for skill selection

skillops agentic remove-skill <agent> <skill>

Remove a specific skill symlink from an agentic IDE.

# Remove 'logger' skill from Claude
skillops agentic remove-skill claude logger

# Remove 'debug-helper' from Windsurf
skillops agentic remove-skill windsurf debug-helper

skillops agentic remove-skills <agent>

Remove all skill symlinks for a specific agentic IDE.

# Remove all skills from Claude
skillops agentic remove-skills claude

# Remove all skills from Windsurf
skillops agentic remove-skills windsurf

Skill Management

skillops pull <url>

Download a new skill repository from GitHub.

# Pull a skill from GitHub
skillops pull https://github.com/github/copilot-docs

# Pull using short format
skillops pull github.com/user/awesome-skill

Supported URL formats:

• https://github.com/user/repo
• github.com/user/repo
• git@github.com:user/repo.git

Example with real repository:

# Pull GitHub Copilot documentation skills
skillops pull https://github.com/github/copilot-docs

skillops list

Show all downloaded skill names and their status across IDEs.

skillops list

Example output:

Available Skills:
  • copilot-docs (active in claude, windsurf)
  • logger-skill (inactive)
  • debug-helper (active in claude)

Status indicators:

• Active: Skill is symlinked to one or more IDEs
• Inactive: Skill is downloaded but not linked to any IDE

skillops remove <name>

Safely delete a pulled skill repository after checking for active links.

# Remove a skill (with safety check)
skillops remove copilot-docs

Safety features:

• Checks for active symlinks before deletion
• Lists affected IDEs
• Requires confirmation for safety

skillops remove-all

Clear all local skill repositories.

# Remove all skills (with confirmation)
skillops remove-all

Warning: This will remove all downloaded skills from ~/.skillops/skills/ directory.

Agentic Configuration

skillops config add-agentic -n <name> -p <path>

Register a new IDE type globally.

# Add a new IDE configuration
skillops config add-agentic -n "cursor" -p "~/.cursor/skills"

# Add VSCode configuration
skillops config add-agentic -n "vscode" -p "~/.vscode/extensions/skills"

skillops config update-agentic -n <name>

Update an existing IDE mapping with interactive path selection.

# Update Claude configuration
skillops config update-agentic -n claude

This opens an interactive prompt to change the skills directory path.

skillops config remove-agentic -n <name>

Remove a registered IDE mapping.

# Remove an IDE configuration
skillops config remove-agentic -n cursor

Complete Workflow Example

Here's a complete workflow from installation to managing skills:

# 1. Pull a skill repository
skillops pull https://github.com/github/copilot-docs

# 2. Check what's available
skillops list

# 3. Navigate to your project
cd /path/to/your/project

# 4. Configure IDEs for current project
skillops agentic
# Select which IDEs to enable (Claude, Windsurf, etc.)

# 5. Manage skills for specific IDE
skillops agentic manage claude
# Toggle skills on/off in the TUI

# 6. Remove unused skill
skillops remove old-skill

Setting Up a New IDE

# 1. Add the new IDE to global config
skillops config add-agentic -n "neovim" -p "~/.config/nvim/skills"

# 2. Navigate to your project
cd /path/to/your/project

# 3. Enable it in current project
skillops agentic

# 4. Add skills to it
skillops agentic manage neovim

Tips and Best Practices

1. Use skillops list frequently to check the status of your skills
2. Always run skillops agentic when setting up a new project
3. Skills are identified by SKILL.md file in the repository root
4. Keep your global config clean by removing unused IDE configurations
5. Symlinks are used to avoid file duplication across projects

Configuration File

All configuration is stored in:

~/.skillops/config/agentics.yaml

This file contains:

• Registered IDE types and their paths
• Global settings
• Skill repository locations