CtrlK
BlogDocsLog inGet started
Tessl Logo

opensea-tool-sdk

Build, register, and gate AI-callable tool endpoints using the OpenSea Tool Registry (ERC-8257) on Base. Scaffold HTTPS tools with JSON Schema interfaces, register them onchain, gate access via NFT ownership, subscriptions, trait gating, or x402 pay-per-call (USDC), and call gated tools. For querying OpenSea marketplace data use opensea-api instead.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body: every section is executable, gating detail is properly pushed to one-level-deep reference files that all exist, and error-recovery guidance is thorough. Remaining gains are modest: tighten the duplicated example commands and make validation checkpoints explicit steps in the registration flow.

DimensionReasoningScore

Conciseness

The body is dense and reference-like — commands, tables, and executable code dominate, and domain-specific concepts (x402, EIP-3009, ERC-8257 manifest hashing) are things Claude does not already know, so explaining them earns their tokens. Minor trimming opportunities keep it at 4 rather than 5: Examples A–F repeat command patterns already shown in sections 1–3, and section 7 includes two full TypeScript blocks where one plus a note would do.

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste-ready `npx @opensea/tool-sdk` CLI commands for every lifecycle stage, complete TypeScript snippets for manifest/handler/adapters, concrete curl examples with real contract addresses, and exact flags (e.g., `--erc20-gate 0xTOKEN_ADDRESS --erc20-min-balance 1000000000000000000`). This matches the 5 anchor (copy-paste ready, specific examples covering common cases) — the open-access, paid, NFT-gated, subscription, ERC-20, and combined-gate cases are all covered.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (scaffold → define manifest → handler → adapter → register → gate → call), and validation/feedback mechanisms exist: `--dry-run` for registration, the `verify`/`inspect`/`smoke`/`dry-run-gate` commands, and a response-code table with per-code recovery actions. It falls short of 5 because the checkpoints are listed as available options rather than woven into the sequence (no explicit "dry-run first, then register, then verify the toolId onchain" step), and the end-to-end examples don't include a verification step after registration.

4 / 5

Progressive Disclosure

The SKILL.md body is a genuine overview and the three referenced files (x402.md, predicate-gating.md, known-predicates.md) all exist, contain substantive material, and are exactly one level deep with no further nesting. References are well signaled with a gating summary table plus per-file descriptions in the References section, and detail (predicate encodings, payment protocol internals) is correctly deferred to them. This matches the 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, highly specific description with excellent distinctiveness and an explicit handoff to sibling skills. Its one structural weakness is the absence of an affirmative 'Use when...' trigger clause, which caps completeness.

Suggestions

Add an affirmative trigger clause, e.g. "Use when building or publishing AI-callable tool endpoints, registering tools onchain, or gating API access with NFTs, subscriptions, or pay-per-call payments."

Include a couple of natural user phrasings as synonyms (e.g., "monetize an API per call", "agent tool") alongside the protocol jargon.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Scaffold HTTPS tools with JSON Schema interfaces, register them onchain, gate access via NFT ownership, subscriptions, trait gating, or x402 pay-per-call (USDC), and call gated tools" — covering the full provider and consumer lifecycle comprehensively. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) and exceeds the 4 anchor, which allows minor coverage gaps; none are evident.

5 / 5

Completeness

The "what" is clear and detailed, but there is no affirmative "Use when..." trigger clause — the only scope guidance is the negative handoff "For querying OpenSea marketplace data use opensea-api instead", which implies when not to use it rather than stating when to use it. Per the guideline that a missing 'Use when' clause (or equivalent explicit affirmative trigger guidance) caps completeness at 3, this fits the 3 anchor (clear what, when missing or only weakly implied) rather than 4.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "register", "gate access", "NFT ownership", "subscriptions", "pay-per-call", "USDC", "tool endpoints" are phrases a user with this need would say. A few natural variations are missing (e.g., "monetize an API", "AI agent tool", "charge per call"), and terms like ERC-8257 are jargon-only, so it sits at the 4 anchor rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — "OpenSea Tool Registry (ERC-8257)" tool publishing/gating — and the explicit handoff to `opensea-api` for marketplace data actively prevents the most likely mis-trigger. Clear niche with distinct triggers and minimal conflict risk, matching the 5 anchor.

5 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (563 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository
ProjectOpenSea/opensea-skill
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.