CtrlK
BlogDocsLog inGet started
Tessl Logo

1inch

1inch DEX aggregator. Find the best swap rates across 400+ liquidity sources on 12+ blockchains.

48

Quality

52%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./public/skills/0xterrybit/1inch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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

The description identifies a clear niche (1inch DEX aggregation) with reasonable specificity about its domain, making it distinctive. However, it lacks explicit trigger guidance ('Use when...') and could benefit from more natural user-facing keywords like 'token swap', 'trade crypto', or 'DeFi'. The description reads more like a product tagline than a skill selection guide.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to swap tokens, find the best exchange rate, trade crypto across chains, or mentions 1inch, DEX aggregation, or DeFi swaps.'

Include more natural trigger terms users would say, such as 'token swap', 'trade crypto', 'exchange tokens', 'best price', 'DeFi', and specific blockchain names like 'Ethereum', 'Polygon', 'BSC'.

List additional concrete actions beyond finding swap rates, such as 'execute token swaps, compare quotes across DEXes, check token allowances, and estimate gas costs.'

DimensionReasoningScore

Specificity

Names the domain (DEX aggregation) and a primary action (find best swap rates), and mentions scope (400+ liquidity sources, 12+ blockchains), but doesn't list multiple concrete actions beyond finding swap rates (e.g., execute swaps, compare quotes, check token prices).

2 / 3

Completeness

Describes what the skill does (find best swap rates via 1inch aggregator) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like '1inch', 'DEX', 'swap rates', 'liquidity sources', and 'blockchains', which are terms a crypto-savvy user would use. However, it misses common variations like 'token swap', 'exchange tokens', 'trade crypto', 'best price', 'DeFi', or specific chain names that users might naturally say.

2 / 3

Distinctiveness Conflict Risk

The description is clearly niche — '1inch DEX aggregator' is a very specific tool/protocol, and the combination of DEX aggregation, swap rates, and multi-chain liquidity sources makes it highly unlikely to conflict with other skills.

3 / 3

Total

8

/

12

Passed

Implementation

64%

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

This skill provides strong, actionable API examples with executable curl commands covering the main 1inch endpoints. Its main weaknesses are the lack of an integrated step-by-step swap workflow with validation checkpoints (critical for financial operations), and the monolithic structure that could benefit from splitting reference tables into separate files. Some content like the referral fee marketing language and feature bullet list adds tokens without adding value for Claude.

Suggestions

Add an explicit numbered workflow for the complete swap process: 1) Get quote → 2) Check allowance → 3) Approve if needed → 4) Get swap tx → 5) Display details to user → 6) Confirm → 7) Execute, with validation at each step.

Remove or minimize the features bullet list and referral fee marketing language ('For high-volume integrations ($10M+), contact 1inch...') — these waste tokens without helping Claude execute tasks.

Provide complete token addresses in the Common Token Addresses table instead of truncated ones (e.g., '0xA0b8...1d0F'), which are unusable for API calls.

Split the Supported Chains table and Common Token Addresses into a separate reference file (e.g., CHAINS.md) to reduce the main skill's length and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with concrete API examples, but includes some unnecessary content: the features bullet list with emoji descriptions, the referral fee marketing section with contact advice for high-volume integrations, and the links section add little value for Claude. The truncated token addresses in the Common Token Addresses table are also unhelpful.

2 / 3

Actionability

Provides fully executable curl commands with proper headers, query parameters, and jq formatting for every API endpoint. The examples are copy-paste ready with clear variable definitions and cover the complete swap workflow (quote, allowance check, approval, swap).

3 / 3

Workflow Clarity

The Safety Rules section lists important checks (display details, check allowance, verify slippage), but these are presented as a disconnected checklist rather than integrated into a sequenced workflow. There's no explicit workflow showing the full swap process: check allowance → approve if needed → get quote → confirm with user → execute swap → verify. For a financial operation involving destructive/irreversible transactions, the lack of an integrated validation flow is a gap.

2 / 3

Progressive Disclosure

The content is reasonably organized with clear section headers, but it's a long monolithic file (~180 lines) with no bundle files to offload reference material. The supported chains table, common token addresses, and limit orders section could be split into separate reference files. Links to external docs are provided but no internal progressive structure exists.

2 / 3

Total

9

/

12

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
Demerzels-lab/elsamultiskillagent
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.