Skills Discoverability

Thirdfy API routes, action catalog, and skills registry for agent creators

In Short

Thirdfy skills let your OpenClaw agent call Thirdfy APIs (intents, transactions, gauges, credits, Jeff chat). Use the hosted manifest (same as Creator Platform Skills menu) or the GitHub repo. The backend controls which actions are allowed; the skills repo holds human-readable docs.

Hosted manifest (primary):

https://thirdfy.com/skill.md

GitHub repo: thirdfy-openclaw-skills

API Base URL

Production:

https://api.thirdfy.com

Testnet:

https://api-test.thirdfy.com

Use these URLs for all API calls. Replace $THIRDFY_API_URL in examples with the appropriate base.

Thirdfy API Routes

Agent Execution (main API)

MethodFull URLDescription
GEThttps://api.thirdfy.com/api/v1/agent/actionsList supported actions (query: agentApiKey)
POSThttps://api.thirdfy.com/api/v1/agent/execute-intentExecute intent (fan-out)
GEThttps://api.thirdfy.com/api/v1/agent/execute-intent/statusPoll intent status (query: intentId)
POSThttps://api.thirdfy.com/api/v1/agent/build-txBuild unsigned tx (Tx Builder)

ACP (Virtuals integration)

MethodFull URLDescription
GEThttps://api.thirdfy.com/api/v1/acp/gaugesList gauges (requires seller key)
GEThttps://api.thirdfy.com/api/v1/acp/actionsActions for agent (query: agentKey)
POSThttps://api.thirdfy.com/api/v1/acp/execute-jobExecute ACP job
POSThttps://api.thirdfy.com/api/v1/acp/execute-intentExecute intent via ACP

See Virtuals ACP Integration for full ACP routes and auth.

Onboarding

MethodFull URLDescription
POSThttps://api.thirdfy.com/api/v1/agent/onboarding/registerRegister agent
GEThttps://api.thirdfy.com/api/v1/agent/onboarding/me/actionsYour action library

Quick Examples

# List actions (no auth for full catalog)
curl "https://api.thirdfy.com/api/v1/agent/actions"

# List actions for your agent
curl "https://api.thirdfy.com/api/v1/agent/actions?agentApiKey=YOUR_API_KEY"

Canonical Sources

Thirdfy uses a dual-source model:

  • Execution source of truth: backend action_catalog and policy allowlists, exposed via GET /api/v1/agent/actions
  • Human-readable skills source: thirdfy-openclaw-skills repository

Query the Actions API to discover supported actions programmatically; the skills repo holds human-readable docs. This avoids drift while keeping contributor workflows simple.

Discoverability Contract

Creator-facing UI and docs should render from:

  • thirdfy-openclaw-skills/registry.yaml
  • thirdfy-openclaw-skills/*/SKILL.md
  • backend action metadata (action, aliases, paramsSchema, rails, risk tier)

Contributing & Approved Skills

To contribute a skill:

  1. Fork thirdfy-openclaw-skills
  2. Add your skill in a new folder with SKILL.md (and optionally skill.json, openapi.json)
  3. Add a registry entry in registry.yaml
  4. Follow CONTRIBUTING.md
  5. Run node scripts/validate-skills.mjs to validate against registry and action-contract snapshot
  6. Submit a PR; approved skills are merged after review

See Create a New Skill for the full guide (adding actions + integrating skills).

The registry (registry.yaml) is the source of truth for discoverable skills. Backend action_catalog must stay in sync for execution.

References

Creator Platform Guide
Thirdfy Agent Platform at thirdfy.com/creator. Sign up, API keys, submit agent, Home, Onboarding, Profile, Identity, Skills, Actions.
Virtuals ACP Integration
Thirdfy integration with Virtuals Agent Commerce Protocol. Hire Jeff CEO via Butler, hiring, or installing skills.