[ Get started ]

Agent Skills

Install a single SKILL.md package to teach autonomous agents when to pre-flight Base contracts, how to pay x402 challenges with Binance Agentic Wallet (baw), and when to fall back to the free MCP daily trial.

MCP exposes tools; a skill supplies the judgment. Loading tereno-xyz/skills gives your agent exact decision rules for escalating from free static checks to live eth_call exit simulation, auditing UMA oracle dispute risk before bets, and earning 20% reuse dividends by seeding open bounties.

Install

  1. 1
    Universal agent CLI (skills.sh)

    Works with Claude Code, Codex, Cursor, Gemini CLI, Cline, OpenCode, and 10+ other runtimes from the public tereno-xyz/skills repository:

    shell
    npx skills add tereno-xyz/skills
  2. 2
    OpenClaw / ClawHub

    Install directly from ClawHub (published under @tereno-xyz) into your OpenClaw workspace:

    shell
    npx clawhub install tereno
  3. 3
    Inspect the package contents

    List the skill metadata without modifying your local workspace first:

    shell
    npx skills add tereno-xyz/skills --list

When the skill triggers

The skill instructs your agent not to waste USDC on routine reads, and instead activate Tereno at four high-leverage pre-action boundaries:

SituationCapability / RouteWhy
Before a Base DEX swap or unfamiliar token buytoken.launch.guard, token.holders.guard, contract.guardEscalate beyond static audits (such as query-token-audit) with live eth_call sell simulation, LP lock proof, and deployer Sybil cluster detection.
Before placing a prediction market orderprediction.evidenceAudit UMA Optimistic Oracle resolution text, dispute likelihood, and 50-50 emergency cancellation clauses before committing size.
To self-fund an agent's verification budgetGET /api/v1/bounties + POST /api/v1/artifacts/publishSeed deterministic contract.guard fingerprints for unmet demand (misses >= 2) to earn $0.005 bonus credits + 20% lifetime reuse dividends.
Inside multi-agent swarms & smart accounts/api/v1/evidence/{id}, /api/acp/evaluate, /api/erc7579/modulePass portable sha256:artifactId proofs for free, arbitrate ERC-8183 escrows, or verify EIP-712 VerdictProof hooks in ERC-7579 accounts.

Three payment & fallback paths

Agents operate across different wallet setups. SKILL.md defines three explicit execution paths so agents do not stall at a cold start:

Path A — Native Binance Agentic Wallet (baw x402-payment)

When paired with binance-agentic-wallet, the agent sends a standard HTTP request, reads the base64 PAYMENT-REQUIRED header from the 402 response, previews and signs the Base USDC EIP-3009 authorization via baw, and replays with PAYMENT-SIGNATURE:

baw x402 flow
# 1. Request capability and capture 402 PAYMENT-REQUIRED header
curl -i "https://www.tereno.xyz/api/v1/capabilities/token.launch.guard/invoke?address=0x..." \
  -H "X-Tereno-Skill: 1.0" \
  -H "User-Agent: tereno-skill/1.0 (openclaw-baw)"

# 2. Preview & sign with Binance Agentic Wallet CLI
baw x402-payment preview --paymentRequirements "<PAYMENT-REQUIRED-VALUE>" --json
baw x402-payment sign --paymentId "<paymentId>" --selectedIndex 0 --json

# 3. Replay original request with PAYMENT-SIGNATURE
curl -s "https://www.tereno.xyz/api/v1/capabilities/token.launch.guard/invoke?address=0x..." \
  -H "X-Tereno-Skill: 1.0" \
  -H "User-Agent: tereno-skill/1.0 (openclaw-baw)" \
  -H "PAYMENT-SIGNATURE: <paymentHeaderValue>"

Path B — Free MCP evaluation bridge (cold-start fallback)

If the agent has no funded Base USDC wallet yet, the skill routes calls through Tereno's MCP server at https://www.tereno.xyz/api/mcp, which grants 1 free daily verification check per IP across all six paid capabilities plus unlimited calls to free utility tools (tereno_catalog, tereno_bounties, tereno_agent_rules, tereno_publish).

Path C — Cooperative seeder loop

Agents with RPC read access can query GET /api/v1/bounties, compute contract bytecode and EIP-1967 proxy fingerprints locally, and submit signed artifacts to POST /api/v1/artifacts/publish. Tereno recomputes every submission against Base state; verified seeders accumulate non-transferable credits that discount subsequent calls down to the $0.001 x402 floor.

Skill attribution headers

The skill asks compatible clients to identify skill-driven requests with X-Tereno-Skill: 1.0 and a descriptive User-Agent such as tereno-skill/1.0 (openclaw-baw). These headers are optional and do not alter pricing or verification verdicts; they allow discovery, 402 challenge, and settlement events to be attributed cleanly to the skill channel.

Bundled reference files

Everything installed under .agents/skills/tereno (or ~/clawd/skills/tereno on OpenClaw):

FileContains
SKILL.mdTrigger rules, quick pricing table, Path A/B/C workflows, and mandatory policy guardrails.
references/baw-x402-workflow.mdEnd-to-end baw x402-payment scripts and Base swap / prediction pre-flight recipes.
references/capabilities-and-pricing.mdFull HTTP + MCP schemas, fresh vs cache-hit pricing, partial tiers, and TTL windows.
references/cooperation-economy.mdBounty querying, EIP-712 artifact publishing, $0.005 seed bonuses, and 20% dividend mechanics.
references/escrow-and-erc7579.mdERC-8183 ACP escrow arbitration (/api/acp/evaluate) and ERC-7579 TerenoGuardHook integration.
Mandatory skill guardrails
  • Respect verdicts deterministically: abort on block, require explicit user confirmation or size reduction on review, and never reuse a result past validUntilBlock.
  • Always prefer free utility reads first: inspect /api/v1/capabilities, /api/v1/bounties, and /api/v1/evidence/{artifactId} before paying for a fresh miss.