AI Skills CLI

@tiktok-fe/skills (ai-skills) discovers, installs, and manages AI agent skills across 30+ platforms.

npm install -g @tiktok-fe/skills
# or: npx @tiktok-fe/skills [command]

Pure Mode (Required)

The CLI defaults to interactive CLI mode with colors, spinners, arrow-key navigation, and confirmation prompts. This WILL hang/block when called by an AI agent. Always use --pure to switch to non-interactive plain-text mode.

What --pure changes

Preventing hangs

Commands that block without proper flags:

# WRONG — will hang on scope selection prompt
ai-skills add my-skill --source local --pure

# CORRECT — scope specified, no prompt
ai-skills add my-skill --source local --project --pure

# WRONG — will silently skip existing skill (shouldOverwrite=false)
ai-skills add my-skill --source local --project --pure

# CORRECT — force overwrite
ai-skills add my-skill --source local --project --pure --force

# WRONG — will hang on confirmation prompt
ai-skills update --project --pure

# CORRECT — auto-confirm
ai-skills update --project --pure -y

# WRONG — will hang on clean confirmation
ai-skills clean --project --pure

# CORRECT — force clean
ai-skills clean --project --pure --force

Complete flag checklist

Every command invoked by an AI agent must include:

1. --pure — plain-text output, no ANSI codes, no interactive prompts
2. Scope flag — -p (project), -g (global), -t \x3Cdir>, or --dir \x3Cdir>
3. Confirmation skip — -y (for update/publish) or --force (for add/remove/clean)
4. --source — local, github, gitlab, codebase, wellknown

Quick Reference

Find skills

ai-skills find "query" --pure --page 1
ai-skills find react --source github --pure
ai-skills find --tag typescript --filter community --pure

Install skills

# From internal registry
ai-skills add skill-name --source local --project --pure -y

# From GitHub (specific skill)
ai-skills add owner/repo --source github --skill skill-name --project --pure -y

# All skills from a repo
ai-skills add owner/repo --source github --project --pure -y

# Force overwrite
ai-skills add skill-name --source local --project --pure --force

List / Remove / Update

ai-skills list --project --pure
ai-skills remove skill-name --project --pure --force
ai-skills update --project --pure -y
ai-skills update --list --project --pure          # check only

Auth & Config

ai-skills whoami --json
ai-skills login --pure
ai-skills config --json

Create & Publish

ai-skills init --name my-skill --template basic --pure
ai-skills publish --dir ./my-skill --pure -y
ai-skills unpublish user/skills/name --version 1.0.0 --pure --force

Other

ai-skills agents --pure                           # list supported agents
ai-skills clean --project --pure --force           # remove all skills

Output Parsing

Common Workflows

Install a skill for a project

ai-skills find typescript --pure --page 1
ai-skills add typescript-config --source local --project --pure -y
ai-skills list --project --pure

Update all project skills

ai-skills update --list --project --pure
ai-skills update --project --pure -y

Publish a new skill

ai-skills whoami --json
ai-skills init --name my-skill --template basic --pure
# (edit SKILL.md)
ai-skills publish --dir ./my-skill --pure -y

Detailed References

For command-specific options, arguments, and output formats, read the corresponding file under llms/:

Read these files only when detailed information is needed for a specific command or topic.