AI Skills CLI#

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

bash

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#

BehaviorCLI mode (default)Pure mode ( --pure)OutputANSI colors, spinners, animationsPlain console.log, no escape codesPromptsInteractive confirmation dialogsSkipped — operations that need confirmation silently failOverwriteAsks "overwrite?" promptAlways returns false — use --force to overwriteSearchReal-time Ink UI with keyboard navPaginated text outputScope selectionInteractive multi-selectFails if not specified — always pass -p/ -g/ -t/ --dirManageInk-based React terminal UIFalls back to list output

Preventing hangs#

Commands that block without proper flags:

bash

# 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 <dir>, or --dir <dir>
3. Confirmation skip — -y (for update/publish) or --force (for add/remove/clean)
4. --source — local, github, gitlab, codebase, wellknown

Quick Reference#

Find skills#

bash

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

Install skills#

bash

# 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#

bash

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#

bash

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

Create & Publish#

bash

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#

bash

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

Output Parsing#

CommandSuccessErroraddInstalled: name``Error:, Already installed:, No agents foundremoveRemoved: name``not found, Cannot remove:updateUpdated: N, Skipped: N, Failed: N—publishPublished: name@ver``Not logged incleanCleaned: N skill(s) removed—loginLogin successful:``Login failed:initCreated: /path/SKILL.md``Error:

Common Workflows#

Install a skill for a project#

bash

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#

bash

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

Publish a new skill#

bash

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/:

TopicFileCLI overviewllms/cli-overview.txtCommandsadd (install)llms/commands/add.txtfind (search)llms/commands/find.txtlistllms/commands/list.txtremovellms/commands/remove.txtupdatellms/commands/update.txtinitllms/commands/init.txtpublishllms/commands/publish.txtunpublishllms/commands/unpublish.txtcleanllms/commands/clean.txtconfigllms/commands/config.txtloginllms/commands/login.txtwhoamillms/commands/whoami.txtagentsllms/commands/agents.txtmanagellms/commands/manage.txtGuidesAI best practicesllms/guides/ai-best-practices.txtSKILL.md formatllms/guides/skill-format.txtSource platformsllms/guides/source-platforms.txtSupported agentsllms/guides/agents-list.txt

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