- name
- bytedance-find-skills
- description
- Manage AI agent skills using the @tiktok-fe/skills CLI (binary: ai-skills). Use when the user asks to find, search, install, add, remove, update, publish, list, or manage AI skills across coding agents (Cursor, Claude Code, GitHub Copilot, Windsurf, etc.), or mentions ai-skills, skill hub, or @tiktok-fe/skills.
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
| Behavior | CLI mode (default) | Pure mode (--pure) |
|---|---|---|
| Output | ANSI colors, spinners, animations | Plain console.log, no escape codes |
| Prompts | Interactive confirmation dialogs | Skipped — operations that need confirmation silently fail |
| Overwrite | Asks "overwrite?" prompt | Always returns false — use --force to overwrite |
| Search | Real-time Ink UI with keyboard nav | Paginated text output |
| Scope selection | Interactive multi-select | Fails if not specified — always pass -p/-g/-t/--dir |
| Manage | Ink-based React terminal UI | Falls back to list output |
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 --forceComplete flag checklist
Every command invoked by an AI agent must include:
--pure— plain-text output, no ANSI codes, no interactive prompts- Scope flag —
-p(project),-g(global),-t <dir>, or--dir <dir> - Confirmation skip —
-y(for update/publish) or--force(for add/remove/clean) --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 --pureInstall 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 --forceList / 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 onlyAuth & Config
ai-skills whoami --json
ai-skills login --pure
ai-skills config --jsonCreate & 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 --forceOther
ai-skills agents --pure # list supported agents
ai-skills clean --project --pure --force # remove all skillsOutput Parsing
| Command | Success | Error |
|---|---|---|
| add | Installed: name | Error:, Already installed:, No agents found |
| remove | Removed: name | not found, Cannot remove: |
| update | Updated: N, Skipped: N, Failed: N | — |
| publish | Published: name@ver | Not logged in |
| clean | Cleaned: N skill(s) removed | — |
| login | Login successful: | Login failed: |
| init | Created: /path/SKILL.md | Error: |
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 --pureUpdate all project skills
ai-skills update --list --project --pure
ai-skills update --project --pure -yPublish 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 -yDetailed References
For command-specific options, arguments, and output formats, read the corresponding file under llms/:
| Topic | File |
|---|---|
| CLI overview | llms/cli-overview.txt |
| Commands | |
| add (install) | llms/commands/add.txt |
| find (search) | llms/commands/find.txt |
| list | llms/commands/list.txt |
| remove | llms/commands/remove.txt |
| update | llms/commands/update.txt |
| init | llms/commands/init.txt |
| publish | llms/commands/publish.txt |
| unpublish | llms/commands/unpublish.txt |
| clean | llms/commands/clean.txt |
| config | llms/commands/config.txt |
| login | llms/commands/login.txt |
| whoami | llms/commands/whoami.txt |
| agents | llms/commands/agents.txt |
| manage | llms/commands/manage.txt |
| Guides | |
| AI best practices | llms/guides/ai-best-practices.txt |
| SKILL.md format | llms/guides/skill-format.txt |
| Source platforms | llms/guides/source-platforms.txt |
| Supported agents | llms/guides/agents-list.txt |
Read these files only when detailed information is needed for a specific command or topic.