CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

1.05x
Quality

79%

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

77%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, information-dense skill body with excellent workflows, validation checkpoints, and error-recovery guidance. Its main weaknesses are length and inline bulk: endpoint parameter tables, curl examples, and the full script catalog belong in reference files rather than SKILL.md.

Suggestions

Move the tools-API endpoint parameter tables and their curl examples into references/rest-api.md, keeping only the CLI table and one example inline.

Move the full MCP tool parameter tables into a reference file (or stream-api.md-style MCP reference), keeping the tool lists and the auto-resolve decision rule inline.

Replace the complete script catalog with the task-guide tables that already map tasks to scripts, and reference a scripts/README.md for the exhaustive listing.

DimensionReasoningScore

Conciseness

The body is dense and mostly command tables rather than concept explanation, but it contains noticeable trimmable bulk: raw curl examples in "Tool discovery" duplicating the CLI table rows above them, full MCP tool parameter tables inlined, and wordy prose in "Agent accounts". More than minor trim (anchor 4) but not padded concept explanation (anchor 2).

3 / 5

Actionability

Fully executable throughout: exact CLI commands with flags, real script paths (all verified present in scripts/), a copy-paste bash block for API-key resolution, a TypeScript SDK snippet, and concrete examples covering the common cases. Matches the top anchor.

5 / 5

Workflow Clarity

The API-key flow is an ordered 4-step sequence with edge cases (401/403 re-fetch, 429 backoff), and batch operations have a pre-bulk checklist with explicit validation (single test request, --limit 1) plus an error-code table with recovery actions and receipt polling for cross-chain mints. The batch-operation cap does not apply since validation is present; matches the top anchor.

5 / 5

Progressive Disclosure

References exist and are clearly signaled (references/authentication.md, rest-api.md, stream-api.md — all real files, one level deep), but large blocks of reference material are inlined in SKILL.md: full endpoint parameter tables with curl examples for the tools API, MCP tool parameter tables, and a complete script catalog — exceeding the anchor-3 example of 200 lines of inline API reference. Structure is good (above 3's unclear signaling) but the inline bulk exceeds 4's "minor organization gaps".

3 / 5

Total

16

/

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 specific, well-scoped description with strong action coverage and excellent sibling-skill boundaries, weakened only by the absence of an explicit positive 'Use when...' trigger clause and a few missing natural keywords. It communicates the what very well but leaves the when to inference.

Suggestions

Add an explicit trigger clause, e.g. "Use when querying OpenSea for NFT or token market data, floor prices, collection stats, drops, or events."

Include a few more natural user phrases such as "mint eligibility", "watchlist", and "marketplace activity" alongside the existing keyword list.

DimensionReasoningScore

Specificity

Enumerates many concrete actions ("Get floor prices, collection stats, NFT details, token data, trending collections, drops, events, search, favorites, profile and collection settings") plus the access methods (CLI, SDK, MCP server, shell scripts). Comprehensive coverage matching the top anchor; the vague tail "other wallet-scoped operations" is trivial.

5 / 5

Completeness

The "what" is clear and detailed, but there is no "Use when..." clause or equivalent positive trigger guidance for this skill — the closing sentence hands trading/swaps off to sibling skills, which implies "when" only by exclusion. Per the rubric guideline, a missing explicit 'Use when' caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural-term coverage ("floor prices", "collection stats", "NFT details", "trending collections", "drops", "favorites") but a few phrases users would naturally say are missing ("mint", "watchlist", "activity", "NFT marketplace"). Fits the score-4 anchor rather than 5 because synonyms are not comprehensive.

4 / 5

Distinctiveness Conflict Risk

Clear niche (OpenSea read/marketplace-data queries) with explicit handoffs ("For trading use opensea-marketplace, for token swaps use opensea-swaps") that actively prevent mis-triggering against sibling skills. 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

Path

opensea-api/SKILL.md

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.