SkillHQ CLI

The official CLI for SkillHQ — the marketplace for production-ready AI skills. Search, install, publish, and manage skills for Claude Code and other AI agents directly from your terminal.

Installation

npm install -g @skill-hq/cli

Requires Node.js 18 or later.

Quick Start

# Log in to your SkillHQ account
skillhq auth login

# Search the marketplace
skillhq search "code review"

# Install a skill
skillhq install my-skill-name

# List installed skills
skillhq list

Commands

Authentication

skillhq auth login     # Log in via browser (opens OAuth flow)
skillhq auth logout    # Clear saved credentials
skillhq auth status    # Show current login status

Marketplace

skillhq search <query>                        # Search for skills
skillhq search <query> --category <category>  # Filter by category
skillhq search <query> --max-price 9.99       # Filter by price
skillhq info <skill-name>                     # Show skill details and version history

Installing Skills

Skills are installed to ~/.claude/skills/<name>/ by default.

skillhq install <skill-name>           # Install globally (default)
skillhq install <skill-name> --project # Install in current project (.claude/skills/)

Managing Installed Skills

skillhq list                  # List all installed skills
skillhq outdated              # Check for available updates
skillhq update <skill-name>   # Update a skill to the latest version
skillhq remove <skill-name>   # Remove a skill

Publishing

# Validate your skill before publishing
skillhq validate ./my-skill

# Publish to the marketplace
skillhq publish ./my-skill --price 4.99 --category productivity

# Update an existing listing
skillhq publish ./my-skill --price 4.99 --category productivity --update --changelog "Bug fixes"

Creating a Skill

A skill is a directory containing a SKILL.md file with YAML frontmatter:

my-skill/
  SKILL.md        # Required — skill definition and instructions
  commands/       # Optional — additional command files
  prompts/        # Optional — prompt templates

SKILL.md frontmatter:

---
name: my-skill-name
description: A short description of what your skill does (50–2000 chars)
version: 1.0.0
author: Your Name
license: MIT
tags: [productivity, code-review]
---

# My Skill

Instructions and content for your skill...

Run skillhq validate ./my-skill to check your skill is ready before publishing.

Links

• Marketplace
• Documentation
• CLI Reference