1inch DEX aggregator. Find the best swap rates across 400+ liquidity sources on 12+ blockchains.
48
52%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/0xterrybit/1inch/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
f45fcb5
Table of Contents
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.