realsee-skills

Realsee Skills

English | 简体中文

Realsee Skills provides installable agent skills for Realsee workflows. Users and agent runtimes can install these skills to generate Realsee outputs from local inputs.

The current skill is argus. It generates Realsee Argus GLB output from a local JPEG image or panorama.

Credentials

Every install path needs three values:

Key	Purpose	Sensitive
REALSEE_APP_KEY	Realsee Open Platform APP_KEY	✅
REALSEE_APP_SECRET	Realsee Open Platform APP_SECRET	✅
REALSEE_REGION	global (app-gateway.realsee.ai) or cn (app-gateway.realsee.cn)	—

Register at my.realsee.ai (global) or my.realsee.cn (cn), then email [email protected] with your account region, UserID, and IdentityID to request Argus VGGT API capability.

Install & Use — Claude Code

One-line install (inside a Claude Code session):

/plugin marketplace add realsee-developer/skills
/plugin install realsee-skills@realsee-developer-skills

Claude Code will prompt you for REALSEE_APP_KEY / REALSEE_APP_SECRET / REALSEE_REGION via the plugin config dialog. The two secrets are stored in the system keychain (not in settings.json).

Use — just describe the task in chat; Claude picks the skill based on its SKILL.md description. Examples:

Turn /path/to/photo.jpg into a Realsee Argus GLB (image mode).
Generate an Argus GLB from /path/to/pano.jpg (panorama, 2:1 aspect).

Need an explicit handle? The plugin-namespaced id is realsee-skills:argus.

Development install from a clone:

git clone https://github.com/realsee-developer/skills.git
cd skills
npm install && npm run rebuild
claude --plugin-dir ./plugins/realsee-skills

Install & Use — Codex

One-line install (host machine):

npx skills add realsee-developer/skills --skill argus --agent codex

This copies .agents/skills/argus/ into $CODEX_HOME/skills/argus (default $HOME/.codex/skills/argus).

Use — export credentials, then reference the skill in your Codex prompt:

export REALSEE_APP_KEY=...
export REALSEE_APP_SECRET=...
export REALSEE_REGION=global   # or cn

Use $argus on /path/to/photo.jpg (image mode) and report the GLB path.

Install from a clone instead (sets CODEX_HOME if you want a custom location):

CODEX_HOME=$HOME/.codex npm run install:codex-skills

Install & Use — npx skills (any detected host)

One-line install for the currently-active agent:

npx skills add realsee-developer/skills --skill argus

Install for all detected hosts in one call:

npx skills add realsee-developer/skills --skill argus --agent '*'

Or target a specific host:

npx skills add realsee-developer/skills --skill argus --agent claude-code
npx skills add realsee-developer/skills --skill argus --agent codex

List skills without installing:

npx skills add realsee-developer/skills --list

Install from a local checkout:

npx skills add . --skill argus

Use — once installed, invoke the skill exactly as you would on each host (see the Claude Code / Codex sections above).

Direct CLI Use (no host required)

Synchronous run (blocks until GLB download; Argus inference can take several minutes):

node .agents/skills/argus/scripts/run-argus.mjs --image /absolute/path/input.jpg --workspace ./workspace --yes --json

Asynchronous (returns immediately with status: in_progress; a detached process polls + downloads):