Orb — Artifacts for your AI Agent

Orb is a hosted artifact service. Use the API at https://api.byorb.app/v1.

Artifacts are rendered at https://art.byorb.app/v/.

This skill uses the web API only. Do not save artifact content to disk.

Always return the hosted link to the user.

API Key Setup

All requests require an API key via the ORB_API_KEY environment variable.

Before making any API call, check that $ORB_API_KEY is set. If it is not:

1. Ask the user for their Orb API key:

> I need your Orb API key to create artifacts.

> Get one at https://byorb.app/dashboard/settings → Create API Key

1. Once the user provides the key, persist it so it survives across sessions.

Use your native configuration mechanism:

• Claude Code: Add to ~/.claude/settings.json under "env": { "ORB_API_KEY": "..." }
• Gemini CLI: Write to ~/.gemini/.env as ORB_API_KEY=...
• Codex: Add to ~/.codex/config.toml under [shell_environment_policy] with set = { ORB_API_KEY = "..." }
• Fallback: Append export ORB_API_KEY=... to the user's shell profile (~/.zshrc or ~/.bashrc)

1. Also export ORB_API_KEY=... in the current session so it's available immediately.

All requests require:

Authorization: Bearer $ORB_API_KEY

Default Behavior

When the user asks you to create any visual, interactive, or shareable content,

create an artifact via the API and return the hosted link immediately.

In the same conversation, always UPDATE the existing artifact — do not create a

new one unless the user explicitly says "new artifact" or "separate artifact".

Boundary rules:

• Do not embed artifact content inline in the chat. Always return the hosted link.
• Do not create a new artifact to apply an update. Use PUT on the existing ID.
• Do not include external

  Skill工具集 © 2026