# great-docs skill install


Install skills for AI coding agents.


``` bash
great-docs skill install [OPTIONS] [SOURCE]
```


SOURCE can be a Python package name or a documentation site URL. If omitted, looks for skills in the current package.


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: great-docs skill install [OPTIONS] [SOURCE]

      Install skills for AI coding agents.

      SOURCE can be a Python package name or a documentation site URL. If omitted,
      looks for skills in the current package.

      Examples:
        great-docs skill install                    # current package (pyproject.toml)
        great-docs skill install great-tables       # any installed package
        great-docs skill install polars pointblank  # multiple packages at once
        great-docs skill install https://posit-dev.github.io/great-tables/
        great-docs skill install great-tables --agent claude           # Claude Code
        great-docs skill install great-tables --agent copilot          # GitHub Copilot
        great-docs skill install great-tables --global                 # install to ~/
        great-docs skill install great-tables --path .claude/skills/gt # custom path
        great-docs skill install --detect           # find and refresh all skills

    Options:
      -g, --global                    Install the skill globally (~/) instead of
                                      in the current repository.
      -p, --path TEXT                 Custom path where to install the skill.
      -d, --detect                    Automatically detect and update existing
                                      installations.
      --agent [claude|copilot|cursor|windsurf|opencode|codex]
                                      Target agent format (auto-detected if not
                                      specified).
      --name TEXT                     Override the skill name.
      --help                          Show this message and exit.


# Arguments


`SOURCE: TEXT`  
Optional.


# Options


`-g, --global`  
Install the skill globally (~/) instead of in the current repository.

`-p, --path: TEXT`  
Custom path where to install the skill.

`-d, --detect`  
Automatically detect and update existing installations.

`--agent: CHOICE`  
Target agent format (auto`-d`etected if not specified).

`--name: TEXT`  
Override the skill name.


# Examples

``` bash
  great-docs skill install                    # current package (pyproject.toml)
  great-docs skill install great-tables       # any installed package
  great-docs skill install polars pointblank  # multiple packages at once
  great-docs skill install https://posit-dev.github.io/great-tables/
  great-docs skill install great-tables --agent claude           # Claude Code
  great-docs skill install great-tables --agent copilot          # GitHub Copilot
  great-docs skill install great-tables --global                 # install to ~/
  great-docs skill install great-tables --path .claude/skills/gt # custom path
  great-docs skill install --detect           # find and refresh all skills
```