Developers · Agent Skills

Give coding agents scoped storefront tools.

The @rareprotocol/rare-profile package ships a plain Markdown skill for Claude, Codex, Cursor, and other agents. It teaches agents how to use the rare-profile CLI for profile metadata, links, stores, products, apps, posts, social, messages, analytics, events, and Studio workflows.

Install and log in

Install the storefront CLI globally, then authorize it through the wallet-less device flow. The CLI prints a user code and sends you to /dashboard/cli; after approval, it stores an slk_ token in your local config.

npm install -g @rareprotocol/rare-profile
rare-profile login
rare-profile whoami

The published package requires Node.js 20+ and can also be installed as a TypeScript SDK with npm install @rareprotocol/rare-profile.

Agent setup

The skill output is regular Markdown, so teams can commit it wherever their agent already reads instructions. Use the same package for Claude skills, Codex AGENTS.md guidance, Cursor rules, or a shared internal agent handbook.

rare-profile skill list
rare-profile skill > .claude/skills/rare-profile-cli/SKILL.md
rare-profile skill >> AGENTS.md
rare-profile skill > .cursor/rules/rare-profile.md

Command surface

Agent instructions point to the same commands a human can run, which keeps automation auditable and easy to replay from a terminal.

profile, link, store

Read and update profile metadata, link pages, storefront settings, and creator-owned commerce surfaces.

product, app, post

Add, list, edit, unlist, delete, and browse digital products, hosted apps, and posts.

follow, feed, messages

Work with social graph, feeds, followers, following, and creator messaging workflows.

stats, events, studio

Inspect storefront analytics, event data, and AI Studio workflows for operational updates.

tokens, version, help

Audit token scopes, confirm installed versions, and discover command-level help.

JSON mode for reliable agents

Use --json or RARE_PROFILE_JSON=1 when an agent needs stable output contracts instead of terminal prose.

rare-profile product list --json
RARE_PROFILE_JSON=1 rare-profile stats overview

{"ok":true,"data":{}}
{"ok":false,"error":{"code":"auth_required","message":"Run rare-profile login"}}

Exit codes distinguish success, generic or API failure, usage errors, and auth-required states.

Clear guardrails

Wallet-less

rare-profile manages creator content and commerce settings, not private keys or wallet custody.

No buying

Purchase and wallet scopes are blocked for CLI tokens, so agents cannot buy products or move funds.

Token work separated

Minting, NFT deployment, auctions, and marketplace actions live in @rareprotocol/rare-cli.