# Pull Provider

> Pull one or more StackQL providers from the registry. Supports version pinning with name@version syntax. Lists available providers when called with --list.

- Skill: `stackql/pull-provider` (Agent Skill)
- Install (CLI): `npx skillmds@latest add stackql/pull-provider`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stackql/pull-provider/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: stackql (https://skillmd.com/u/stackql)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/stackql/pull-provider

---


Arguments: `$@`

## Step 1 - Check StackQL is installed

```bash
command -v stackql
```

If not found, delegate to `/stackql-skills:install-stackql` and then continue.

## Step 2 - Handle --list flag

If `--list` is in `$@`, list all available providers:

```bash
stackql exec "REGISTRY LIST;" --output json
```

Present the results as a table showing provider name and version, then stop.

## Step 3 - Show currently installed providers

```bash
stackql exec "SHOW PROVIDERS;" --output json
```

Note which providers are already installed so you can report additions vs updates.

## Step 4 - Pull each provider

For each argument in `$@`:

- `name` -> `REGISTRY PULL name;`
- `name@version` -> `REGISTRY PULL name v<version>;`

Run each pull command:

```bash
stackql exec "REGISTRY PULL <provider>;"
```

Or with a version:

```bash
stackql exec "REGISTRY PULL <provider> v<version>;"
```

## Step 5 - Verify

After pulling, verify the providers are available:

```bash
stackql exec "SHOW PROVIDERS;" --output json
```

## Step 6 - Report

For each provider pulled, report success or failure. If successful, suggest next steps:

> Provider `<name>` is ready. Next steps:
> - Set up auth: `/stackql-skills:auth-setup <name>`
> - Explore services: `/stackql-skills:explore <name>`
> - Run a query: `/stackql-skills:query "SELECT ... FROM <name>.<service>.<resource> WHERE ..."`