Create a New Skill

Overview

This guide explains how to create a new skill in the thirdfy-openclaw-skills repository. Skills are installable runtime docs that wrap existing Thirdfy actions — swap, vote, claim, get-yield-pools, and more.

Create a New Skill (Skills Repo Only)

1. Add SKILL.md

In thirdfy-openclaw-skills, create a new folder and SKILL.md:

• Required frontmatter: name, description, version, tags, metadata
• Required sections: ## Required Environment, ## Core Endpoints, ## Operational Guidance
• See existing skills (e.g. thirdfy-intent-api/SKILL.md) for structure

2. Add Registry Entry

In registry.yaml:

- id: your-skill-id
  primary: false   # true only for thirdfy-intent-api
  owner: thirdfy-core
  version: 1.0.0
  lifecycle: stable
  riskTier: medium
  executionModel: model_a   # or model_b, hosted, utility
  integrationMode: api_connector
  custodyMode: managed
  primaryRail: execute_intent
  sourcePath: your-skill-id/SKILL.md
  actionContractMode: dynamic_discovery   # discover actions via GET /api/v1/agent/actions at runtime
  actionContractSource: ../ThirdfyAPI/thirdfy-api-v2/docs/acp/action-contract.snapshot.json   # same as other skills; validation skips if snapshot unavailable
  rails:
    - agent_runtime
  requiredEnv:
    - THIRDFY_API_URL
    - THIRDFY_AGENT_API_KEY

Use dynamic_discovery when your skill discovers actions at runtime via GET /api/v1/agent/actions. Use static only if you reference a fixed list of actions that exist in the current catalog.

3. Validate

cd thirdfy-openclaw-skills
node scripts/validate-skills.mjs

4. Submit PR

• Follow CONTRIBUTING.md
• Your skill must call existing Thirdfy API endpoints — do not invent new actions
• Skills document how to use the API; execution semantics stay in Thirdfy's backend

Skill Types

Integration Pattern for External Builders

To integrate your agent with Thirdfy:

1. Install thirdfy-intent-api (primary skill)
2. Call GET /api/v1/agent/actions?agentApiKey=... to discover allowed actions
3. Submit via POST /api/v1/agent/execute-intent
4. Poll status with GET /api/v1/agent/execute-intent/status?intentId=...

This keeps integrations scalable as Thirdfy adds new providers.

References

• thirdfy-openclaw-skills — Skills repo
• Skills Introduction — Overview and execution models
• Install Skills — User install guide
• Skills Discoverability — API routes, registry