# dx-cli

Connects your agent to DX APIs through the CLI to manage software catalogs, scorecard health checks, and engineering metrics.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 9
- Author: get-dx
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/get-dx/cli/tree/HEAD/skills/dx-cli/SKILL.md
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/skills/dx-cli

## What it does

This skill allows an agent to run `dx` CLI operations against the getdx.com API. It lets you query entities and entity types inside the Software Catalog, inspect scorecard check results across services, and view tasks assigned to teams. You can also analyze survey slices from Snapshot and manage tiles inside Data Studio reports.

The skill also resolves platform administration questions. Instead of guessing, the agent queries `llms.txt` and pulls the relevant Markdown page from docs.getdx.com to retrieve exact setup sequences for SSO or GitHub connectors. CLI commands support machine-readable output through the `--json` flag.

All CLI interactions require network connectivity and an authenticated session. Run `dx auth login` or `dx init` before issuing requests, because unauthenticated commands fail immediately.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add get-dx/cli --skill dx-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dx-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dx-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add get-dx/cli --skill dx-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dx-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add get-dx/cli --skill dx-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dx-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install get-dx/cli dx-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/dx-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add get-dx/cli --skill dx-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/get-dx/cli --path skills/dx-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dx-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add get-dx/cli --skill dx-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/get-dx/cli/tree/HEAD/skills/dx-cli/SKILL.md

## When to use it
- Inspect service health and SQL checks across scorecards
- Query and modify entities within the Software Catalog
- Review survey score distributions across attribute groups
- Fetch exact setup procedures for connectors from official docs

## Example prompts
- Check the scorecard status for entity `billing-service`
- Run `dx auth whoami` to inspect the active credentials
- Find the step-by-step GitHub backfill guide in DX documentation

## Similar
- [wizard](https://affpapa.org/en/nevibecode/skills/wizard.md) — skill · 553369 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [using-git-worktrees](https://affpapa.org/en/nevibecode/skills/using-git-worktrees.md) — skill · 217153 installs
- [finishing-a-development-branch](https://affpapa.org/en/nevibecode/skills/finishing-a-development-branch.md) — skill · 214439 installs
- [orca-cli](https://affpapa.org/en/nevibecode/skills/orca-cli.md) — skill · 353600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md