<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->

# pai skill

> Skill telemetry and (future) discovery for the self-educating skill system

## Synopsis

```
pai skill <subcommand> [options]
```

## Subcommands

| Command | Description |
|---------|-------------|
| [`pai skill telemetry`](#pai-skill-telemetry) | Show skill-invocation telemetry (triggers, last used, projects) |

### pai skill telemetry

Show skill-invocation telemetry (triggers, last used, projects)

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--scope <scope>` | Governance scope | `default` |
| `--status <status>` | Filter by status: trial \| active \| archived |  |
| `--limit <n>` | Maximum rows | `50` |
| `--json` | Output raw JSON |  |


## Examples

```bash
# Which skills have actually been triggered, most-used first
pai skill telemetry

# Only skills still in trial (quarantined, not yet promoted)
pai skill telemetry --status trial

# Machine-readable output for dashboards
pai skill telemetry --json
```

See `Notes/swarm/skills-self-educating.md` for the full self-educating loop
(discovery, sandbox trial, telemetry, adaptation).

## See also

[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)

Run `pai help <area>` to read any of these in the terminal.

