# Install visualize 0.5.1

You were asked to install the free, open-source visualize Agent Skill. Do not
create, edit, upload, or publish an artifact as part of setup.

## Approval boundary

1. Identify the active host from runtime or command evidence first. Treat
   filesystem markers only as hints.
2. If more than one host still matches, ask the user which active host to set up.
3. Inspect project-local and user-level locations for an existing `visualize` skill.
4. Tell the user what you found, which path you propose to change, and whether
   an existing installation would be replaced.
5. Ask for approval before writing or replacing files.

Do not install a duplicate. If two copies already exist, stop and explain which
one the host resolves first. Never delete a copy without explicit approval.

## Reviewed release

- Version: 0.5.1
- Commit: bdbf79c2b603badd8ae3bbc0231436142505377f
- Repository: https://github.com/display-dev/visualize

## Host-specific branches

Use exactly one unambiguous matching branch. Do not silently substitute one
host's mechanism for another.

### Cursor

- Detect: Confirm the active runtime is Cursor. A .cursor directory alone is only a hint and is not sufficient.
- Expected path: `.agents/skills/visualize or ~/.cursor/skills/visualize`
- Mechanism: The reviewed commit-pinned Agent Skills installer.
- Install after approval:

```sh
npx skills@1.5.9 add display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f --skill visualize
```
- Reload: Reload the Cursor window or start a new agent conversation.
- Verify: Ask the active host to list or discover installed skills and confirm visualize appears from the expected path.

### Codex

- Detect: Confirm the active runtime is Codex. AGENTS.md is shared by other hosts and is not sufficient evidence.
- Expected path: `.agents/skills/visualize or ~/.codex/skills/visualize`
- Mechanism: The reviewed commit-pinned Agent Skills installer.
- Install after approval:

```sh
npx skills@1.5.9 add display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f --skill visualize
```
- Reload: Start a new Codex conversation so skill discovery runs again.
- Verify: Ask the active host to list or discover installed skills and confirm visualize appears from the expected path.

### Claude Code

- Detect: Confirm the active runtime is Claude Code. A CLAUDE.md or .claude directory alone is only a hint.
- Expected path: `.claude/skills/visualize or ~/.claude/skills/visualize`
- Mechanism: The tested Claude Code path through the pinned Agent Skills installer.
- Install after approval:

```sh
npx skills@1.5.9 add display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f --skill visualize
```
- Reload: Start a new Claude Code conversation so skill discovery runs again.
- Verify: Ask the active host to list or discover installed skills and confirm visualize appears from the expected path.

### OpenCode

- Detect: Confirm the active runtime is OpenCode. AGENTS.md is shared by other hosts and is not sufficient evidence.
- Expected path: `.agents/skills/visualize or ~/.config/opencode/skills/visualize`
- Mechanism: The reviewed commit-pinned Agent Skills installer.
- Install after approval:

```sh
npx skills@1.5.9 add display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f --skill visualize
```
- Reload: Restart the OpenCode session.
- Verify: Ask the active host to list or discover installed skills and confirm visualize appears from the expected path.

### Hermes

- Detect: Confirm the active runtime is Hermes and inspect its well-known design-skill mounts.
- Expected path: `.hermes/skills/visualize or ~/.hermes/skills/visualize`
- Mechanism: The pinned Agent Skills installer detects hermes-agent and installs the reviewed bundle without a fixed checkout or recursive overlay.
- Install after approval:

```sh
npx skills@1.5.9 add display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f --skill visualize
```
- Reload: Restart the Hermes agent session.
- Verify: Run hermes skills list and confirm visualize resolves from the approved project or global scope.

### Pi

- Detect: Confirm the active runtime is Pi and that the pi package command is available.
- Expected path: `skills/visualize/SKILL.md inside Pi's installed Git package`
- Mechanism: Pi's native Git-package installer with the reviewed commit as its ref.
- Install after approval:

```sh
pi install git:github.com/display-dev/visualize@bdbf79c2b603badd8ae3bbc0231436142505377f
```
- Reload: Run /reload or restart Pi.
- Verify: Run pi list, then ask Pi to list or discover skills and confirm visualize resolves from the installed display-dev/visualize Git package.

For another Agent Skills host, inspect its documentation or existing skill
layout first. Propose the narrowest project-local path; do not guess and write.

Verification ends there. Do not run `teach`, modify `DESIGN.md`, sign in to
display.dev, or publish a test artifact.

Original setup request: Fetch https://usevisualize.ai/agent-setup.md and follow the instructions.