Skills

Skills are reusable automation scripts that extend pb with app-specific commands. Visit the Skills repository for available skills.

List Skills

pb skills list

List all installed skills (built-in and user-installed).

Text

NAME          KIND      ENABLED   VERSION    DESCRIPTION
googleplay    builtin   yes       1.0.0      Google Play Store automation
tiktok        builtin   yes       1.0.0      TikTok automation
my-skill      user      yes       0.1.0      My custom skill

JSON

{
  "code": 200,
  "data": {
    "skills": [
      {
        "name": "googleplay",
        "source_kind": "builtin",
        "enabled": true,
        "version": "1.0.0",
        "description": "Google Play Store automation"
      }
    ]
  },
  "msg": "OK"
}

Install Skill

pb skills install [path_or_url] [--force]

Install skills. Without arguments, extracts all built-in skills. With a path or URL, installs a user skill (including its dependencies).

Parameter	Type	Required	Description
path_or_url	string	No	Local path or HTTP(S) URL. Omit to install built-in skills
--force	flag	No	Overwrite existing skills with the same name

Examples:

# Install (or refresh) all built-in skills
pb skills install

# Install a skill from a Git repository
pb skills install https://github.com/user/my-skill

# Install from a local directory
pb skills install ./my-skill --force

Create Skill

pb skills new <name> [options]

Scaffold a new skill from a template. Requires git to be installed on your system. The template is cloned from phonebase-cloud/phonebase-skill-template.

Parameter	Type	Required	Description
name	string	Yes	Skill name (used as directory name and pb subcommand)
--package	string	No	Target Android package name. In interactive mode, omit to choose from installed apps on the connected device
--description	string	No	One-line description
--category	string	No	Category slug (social, communication, video, tools, etc.)
--requires	string	No	Dependency skill name (can be repeated)
--force	flag	No	Overwrite an existing skill directory

Example:

pb skills new my-app --package com.example.app --description "My App automation"

Uninstall Skill

pb skills uninstall <name>

Uninstall a user-installed skill. Built-in skills cannot be uninstalled (use pb skills disable instead).

Parameter	Type	Required	Description
name	string	Yes	Skill name to uninstall

Example:

pb skills uninstall my-skill

Enable Skill

pb skills enable <name>

Enable a previously disabled skill.

Parameter	Type	Required	Description
name	string	Yes	Skill name to enable

Example:

pb skills enable googleplay

Disable Skill

pb skills disable <name>

Disable a skill without uninstalling it.

Parameter	Type	Required	Description
name	string	Yes	Skill name to disable

Example:

pb skills disable googleplay

Running Skill Commands

Once a skill is installed, its commands become available as top-level pb subcommands:

# Run a skill command
pb googleplay search --keyword "twitter"
pb googleplay open
pb tiktok search --keyword "cooking"

Each skill defines its own commands in its SKILL.md manifest. Use pb skills list to see available skills and their commands.