CtrlK
BlogDocsLog inGet started
Tessl Logo

opensea-swaps

Swap ERC20 tokens across supported chains via OpenSea's cross-chain DEX aggregator. Get quotes with optimal routing, check token balances, and execute swaps. For NFT trading use opensea-marketplace, for querying token data use opensea-api.

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

Highly actionable and well-structured with good progressive disclosure, but held back by redundant example repetition and the lack of an explicit validation checkpoint in the destructive swap-execution workflow.

Suggestions

Collapse the repeated quote example (Quick start, Task guide, MCP) into one canonical example referenced from the other sections.

Add an explicit sequenced swap workflow with a validation checkpoint, e.g. "1. Get quote; 2. Verify token contract addresses and recipient; 3. Only then execute swap."

DimensionReasoningScore

Conciseness

Mostly efficient with tables and concrete commands assuming competence, but the same quote example recurs across Quick start, Task guide, and MCP sections with near-identical arguments, so it could be tightened.

2 / 3

Actionability

Provides fully executable, copy-paste-ready commands (opensea CLI, mcporter MCP calls with full JSON args, shell script) plus concrete parameter tables — no pseudocode.

3 / 3

Workflow Clarity

Tasks are listed (quote, execute, check balances) but for an irreversible financial operation there is no explicit validate-then-execute checkpoint in sequence; the security warning to verify addresses sits outside the workflow, capping clarity at 2.

2 / 3

Progressive Disclosure

Well-organized overview with a clearly signaled one-level-deep reference (references/token-swaps.md, a real file) and external doc links; content appropriately split between SKILL.md and the reference.

3 / 3

Total

10

/

12

Passed

Description

82%

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, third-person description with strong action coverage and clear distinctiveness through handoffs. Its main weakness is the absence of an explicit positive "Use when..." trigger clause, relying on implied negative-scope guidance instead.

Suggestions

Add an explicit positive trigger clause, e.g. "Use when the user wants to swap ERC20 tokens, request a swap quote, or check token balances across chains."

Drop or de-emphasize the jargon "cross-chain DEX aggregator" in favor of more natural phrasing a user would actually say.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: "Get quotes with optimal routing, check token balances, and execute swaps" — names specific operations rather than abstract capabilities.

3 / 3

Completeness

Clearly answers "what" (swap/quote/balance/execute) but the "when" is only implied via negative-scope handoff ("For NFT trading use opensea-marketplace..."), with no explicit "Use when..." positive trigger clause, which caps completeness per the rubric guideline.

2 / 3

Trigger Term Quality

Natural terms users would say are well covered — "Swap ERC20 tokens", "Get quotes", "token balances", "NFT trading", "token data" — alongside the more technical "DEX aggregator".

3 / 3

Distinctiveness Conflict Risk

Clear niche (ERC20 swaps) with explicit handoffs to opensea-marketplace and opensea-api, making it unlikely to trigger for the wrong skill.

3 / 3

Total

11

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

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.