Installing Skills

Learn how to find, install, and use skills in your projects.

Quick Start

The fastest way to install a skill is using npx. No installation required — just run the command and the skill will be added to your project.

Install a skill
npx tokenui.sh add <skill-name>

Finding Skills

Browse the Gallery

Visit the TokenUI gallery to browse available skills. Each skill card shows:

  • Preview thumbnail of the skill
  • Author information
  • View count and star count
  • Category and description

Search by Name

You can search for specific skills using the CLI:

Search for button-related skills
npx tokenui.sh list --search button

Filter by Category

Skills are organized by category. Use the category filter to narrow down results:

List all form-related skills
npx tokenui.sh list --category forms

Installation Methods

1

Install by Name

Install a specific skill by its name:
npx tokenui.sh add button
2

Install by Author/Skill

For skills with specific authors, use the full path:
npx tokenui.sh add username/skill-name
3

Install Multiple

Install multiple skills at once:
npx tokenui.sh add button card modal input

Installation Options

Custom Path

Install skills to a custom directory in your project:

Install to custom directory
npx tokenui.sh add button --path ./app/components

Force Overwrite

Overwrite existing files if they already exist:

Force overwrite existing files
npx tokenui.sh add button --force

Dry Run

Preview what would be installed without making changes:

Preview installation changes
npx tokenui.sh add button --dry-run

What Gets Installed

When you install a skill, the following files are added to your project:

  • SKILL.md — The main documentation file with usage instructions
  • Component files — Any code files included with the skill
  • Dependencies — Required packages are detected and suggested

By default, skills are installed to the ./.agents/skills/ directory. You can customize this in your tokenui.json configuration file.

Using Installed Skills

For AI Agents

Once installed, AI agents can read the SKILL.md file and follow the instructions to implement the patterns. Reference skills in your prompts:

Example AI prompt
# Example prompt
Create a login form using the button and input skills from tokenui.

For Developers

You can also read the SKILL.md files directly to understand the patterns and copy code examples into your project. Skills are just documentation — you have full control over how you use them.

Updating Skills

To update a skill to its latest version:

Update a specific skill
npx tokenui.sh update button

To update all installed skills at once:

Update all skills
npx tokenui.sh update --all

Removing Skills

To remove a skill from your project:

Remove a skill
npx tokenui.sh remove button

Use the --force flag to skip the confirmation prompt:

Remove without confirmation
npx tokenui.sh remove button --force