╭─╮╭──╮
 ╭╯ ╰╯   ╮
 ╰═══════╯

CLI Documentation

Install and manage agent skills from the command line.

Quick Start

Run the CLI directly with npx — no global install required:

Requires Node.js >= 18

Prerequisites

  • Node.js >= 18 — required to run npx commands
  • SKILLS CLOUD account — sign in at skills-cloud.dev with your Google account

Authentication

When you run npx skillscl for the first time, the CLI will open your browser to sign in with your SKILLS CLOUD account. After signing in, your credentials are stored locally so you don't need to authenticate again. 

┌──────────┐       ┌─────────────┐       ┌──────────────┐
│  CLI     │──1──▶│  Browser    │──2──▶│  SKILLS      │
│  skillscl│◀─4──│  localhost   │◀─3──│  CLOUD Auth  │
└──────────┘       └─────────────┘       └──────────────┘

1. CLI opens browser to auth URL
2. User signs in with Google
3. Auth server redirects with token
4. CLI receives token and stores credentials

Commands

npx skillscl

Launch interactive mode. Browse your saved skills and install them into the current project.

npx skillscl add <owner/repo/skill>

Add a skill directly by its identifier. Skips interactive selection.

$ npx skillscl add hayashikoji/skills/my-skill

npx skillscl publish <skill-name> [--private]

Publish a skill to SKILLS CLOUD. Requires a SKILL.md with frontmatter in the skill folder.

$ npx skillscl publish my-skill

Use --dir <path> to specify a custom skills directory.

Use --private to publish as a private skill (only you can install it).

npx skillscl install <uid/skill-name>

Install a published skill. Public skills require no authentication. Private skills will prompt you to sign in and verify ownership. Downloads are cached at ~/.skillscl/cache/.

$ npx skillscl install abc123/my-skill

npx skillscl status

Check your current authentication status and signed-in account.

npx skillscl logout

Sign out and remove stored credentials from your machine.

npx skillscl help

Display available commands and usage information.

npx skillscl --version

Print the current CLI version.

Publishing Skills

Share your own skills with the community by publishing them to SKILLS CLOUD.

1. Create a SKILL.md

Your skill folder must contain a SKILL.md file with YAML frontmatter: 

---
name: my-skill
description: A brief description of what this skill does
---

# My Skill

Detailed instructions for the AI agent...

2. Place in a skill directory

The CLI searches the following directories in your project:

  • .claude/skills/
  • .cursor/skills/
  • .codex/skills/
  • .agents/skills/
  • skills/

3. Publish

The CLI will prompt you to choose visibility (Public or Private) and safety confirmations, then upload your skill. If a skill with the same name already exists, you'll be asked to confirm before overwriting.

Use --private to skip the visibility prompt and publish as private directly:

$ npx skillscl publish my-skill --private

You can change visibility anytime from the skill's detail page on the web.

4. Others can install it

Once published as public, anyone can install your skill — no authentication required:

$ npx skillscl install <your-uid>/my-skill

Private skills require the owner to be signed in to install.

Limits & Rules

  • Max 5 MB per skill (zip size)
  • Max 30 MB total storage per account
  • Skill name must be alphanumeric and hyphens only (e.g. my-skill)
  • SKILL.md must include name and description in frontmatter
  • Do not include API keys, secrets, or credentials
  • Do not publish malicious or harmful code

Configuration

After authentication, your credentials are stored locally at:

~/.skillscl/credentials.json

This file contains your authentication token. Do not share it or commit it to version control. The CLI reads this file automatically on each run.

Troubleshooting

"Node.js version not supported"

Ensure you are running Node.js 18 or later. Check with node -v.

"Authentication failed"

Try running npx skillscl logout and then sign in again. Make sure your browser is not blocking popups.

"Skill not found"

Verify the skill identifier matches the format owner/repo/skill. Check the skill exists on SKILLS CLOUD.

Browser does not open

If the browser fails to open automatically, copy the URL printed in the terminal and open it manually.

Ready to get started?

Browse available skills and install them in seconds.

Browse Skills