1inch DEX aggregator. Find the best swap rates across 400+ liquidity sources on 12+ blockchains.
69
Quality
59%
Does it follow best practices?
Impact
Pending
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, specific domain (1inch DEX aggregation) with good distinctiveness, but lacks completeness by omitting explicit trigger conditions. It would benefit from more specific actions and natural user trigger terms to help Claude know when to select this skill over others.
Suggestions
Add a 'Use when...' clause with trigger terms like 'swap tokens', 'best exchange rate', 'trade crypto', 'token exchange', or '1inch'
Expand specific actions beyond 'find rates' to include 'execute swaps', 'compare routes', 'check slippage', or 'estimate gas fees'
Include common user phrases like 'swap ETH for USDC', 'exchange tokens', 'best price for trading' to improve trigger term coverage
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (DEX aggregator) and one action (find swap rates), but doesn't list multiple concrete actions like executing swaps, comparing routes, or checking gas costs. | 2 / 3 |
Completeness | Describes what it does (find swap rates) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like '1inch', 'DEX', 'swap rates', 'liquidity', and 'blockchains', but misses common user variations like 'token swap', 'exchange tokens', 'trade crypto', or 'best price'. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche with '1inch DEX aggregator' - clearly distinguishable from other crypto or trading skills, unlikely to conflict with general blockchain or other DEX-specific skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted API reference skill with excellent actionability - all examples are executable and properly formatted. The main weakness is the lack of an integrated workflow showing the complete swap process with validation checkpoints (allowance check → approval → quote → confirmation → execution). The content is appropriately concise but could benefit from better progressive disclosure for advanced features.
Suggestions
Add a 'Complete Swap Workflow' section showing the full sequence: 1) Check allowance, 2) Approve if needed, 3) Get quote, 4) Display to user for confirmation, 5) Execute swap - with explicit validation at each step
Include a validation checkpoint after getting the swap quote to verify price impact and expected output before proceeding to execution
Consider splitting Fusion Mode and Limit Orders into separate reference files, keeping SKILL.md as a quick-start overview
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, presenting API endpoints with executable examples without explaining what DEX aggregators are or how blockchain swaps work. Every section serves a clear purpose with no padding. | 3 / 3 |
Actionability | All examples are fully executable curl commands with proper variable setup, headers, and jq parsing. Users can copy-paste and modify the wallet address to use immediately. | 3 / 3 |
Workflow Clarity | While individual API calls are clear, the skill lacks explicit workflow sequencing for the full swap process (check allowance → approve if needed → get quote → execute swap). The Safety Rules section lists checks but doesn't integrate them into a step-by-step workflow with validation checkpoints. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but it's a monolithic file with no references to external documentation for advanced topics like Fusion Mode details or limit order signing. The 180+ lines could benefit from splitting advanced features into separate files. | 2 / 3 |
Total | 10 / 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 | |
45f9fac
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.