CtrlK
BlogDocsLog inGet started
Tessl Logo

opensea-api

Query OpenSea marketplace data via the official CLI, SDK, MCP server, or shell scripts. Get floor prices, collection stats, NFT details, token data, trending collections, drops, events, search, favorites, profile and collection settings, and other wallet-scoped operations. For trading use opensea-marketplace, for token swaps use opensea-swaps.

75

1.05x
Quality

80%

Does it follow best practices?

Impact

90%

1.05x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./opensea-api/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-sequenced skill body: exhaustive concrete commands, an exemplary ordered key-resolution workflow with validation and recovery, and real, well-signaled one-level-deep references. The main cost is size — a large fraction of it is inline endpoint/parameter reference material that duplicates the role of the bundle's reference files.

Suggestions

Move the ERC-8257 tool endpoint parameter tables and their curl examples, and the per-endpoint MCP parameter tables, into references/rest-api.md, keeping only the task tables and one example inline.

Trim the duplicated tool-command listings (e.g. CLI install/auth snippets repeated in both 'Quick start' and 'OpenSea CLI') to a single canonical section.

Consider collapsing the complete per-script catalog into the reference file, linking only the script families used in task tables.

DimensionReasoningScore

Conciseness

The body largely avoids concept explanations Claude already knows and uses dense tables rather than prose, but at ~870 lines / ~45KB it inlines substantial reference material — full tool-endpoint parameter tables with five curl examples, MCP tool parameter tables for every endpoint, and a complete per-script catalog — that belongs in the existing references. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than score 4, because the trimmable inline reference content is more than minor.

3 / 5

Actionability

Nearly every task row gives a copy-paste-ready command with concrete arguments (e.g. 'opensea nfts get ethereum 0xbc4c... 1234'), curl examples include headers, the key-resolution fallback is a complete executable bash block, and SDK code is runnable TypeScript. This matches the score-5 anchor 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The API key resolution section is an explicitly ordered 4-step flow with checkpoints ('Save immediately after fetching... before making your API call') and a feedback loop for stale keys (401/403 → re-fetch with --force). Batch/destructive operations are covered by a pre-bulk-operation checklist with a verify-first request and limit=1 test, and the error table gives per-status retry actions. This matches the score-5 anchor with explicit validation steps, error-recovery loops, and a checklist.

5 / 5

Progressive Disclosure

Bundle structure is good: references/authentication.md, rest-api.md, and stream-api.md all exist, are clearly signaled at point of use ('Read the wallet authentication reference before acting as a wallet'), and are one level deep; scripts are cataloged per directory. It falls short of score 5 because sizeable reference-grade content (the ERC-8257 tool endpoint parameter tables and curl examples, and the per-endpoint MCP parameter documentation) is inlined in SKILL.md rather than split into the existing references — matching 'Good structure... references mostly clear; minor organization gaps'.

4 / 5

Total

17

/

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, information-dense description: specific, tool-named, comprehensive on capabilities, and with explicit conflict-avoidance handoffs. Its one real weakness is the absence of a positive 'Use when...' trigger clause, leaving the 'when' side answered only implicitly.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about NFT collections, floor prices, NFT or token data, drops/mints, marketplace activity, or OpenSea specifically.'

Include a few natural synonym phrases users actually say (e.g. 'mint', 'watchlist', 'portfolio/P&L') in the capability list to broaden trigger-term coverage.

Mirror the negative handoffs with one positive scope sentence so the description answers 'when to use this' as clearly as it answers 'when not to'.

DimensionReasoningScore

Specificity

The description names concrete tools ("via the official CLI, SDK, MCP server, or shell scripts") and enumerates many specific actions — "floor prices, collection stats, NFT details, token data, trending collections, drops, events, search, favorites, profile and collection settings" — which matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'. It sits above the score-4 anchor because coverage of the skill's operations is near-exhaustive rather than having minor gaps.

5 / 5

Completeness

The 'what' is clear and concrete, but there is no positive 'Use when...' trigger clause — only negative routing ("For trading use opensea-marketplace, for token swaps use opensea-swaps"), which tells when NOT to use it but only weakly implies when to use it. The judging guideline that a missing 'Use when' clause or equivalent explicit trigger guidance caps completeness at 3 applies; it cannot score 4, which requires both 'what' and an explicit 'when'.

3 / 5

Trigger Term Quality

Phrases like "floor prices", "collection stats", "trending collections", "drops", "events", and "search" are terms users would naturally say when needing OpenSea data. It falls short of the score-5 anchor ('comprehensive coverage of natural terms including synonyms') because common user phrasings like "mint", "watchlist", "NFT floor price", and "P&L/portolio" are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche ("OpenSea marketplace data") and explicitly hands off adjacent needs to sibling skills ("For trading use opensea-marketplace, for token swaps use opensea-swaps"), minimizing the chance of triggering for the wrong skill. This matches the score-5 anchor 'Clear niche with distinct triggers; minimal conflict risk'.

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 (889 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 5 deeper-than-1-level

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.