sushiswap-sdk

TypeScript SDK for interacting with the SushiSwap Aggregator and related primitives. This SDK is a typed wrapper over the SushiSwap API, providing ergonomic helpers for token amounts, prices, quotes, and swap transaction generation. USE THIS SKILL WHEN: - Building TypeScript or JavaScript applications - You want strongly typed token, amount, and fraction primitives - You need to request swap quotes or executable swap transactions via code - You want safer arithmetic, formatting, and comparisons without floating point errors - You prefer SDK-based integration over raw HTTP requests

2.96x

Quality

71%

Does it follow best practices?

Impact

95%

2.96x

Average score across 3 eval scenarios

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./public/skills/0xmasayoshi/sushiswap-sdk/SKILL.md

Quality

Discovery

85%

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

This is a strong skill description that clearly identifies its domain (SushiSwap SDK), lists concrete capabilities, and includes an explicit 'USE THIS SKILL WHEN' section with multiple trigger conditions. Its main weakness is that trigger terms could be broader to capture more natural user phrasings around DeFi/DEX concepts. The description uses appropriate third-person voice throughout.

Suggestions

Add broader DeFi-related trigger terms like 'DEX aggregator', 'token swap', 'DeFi', 'crypto exchange', 'on-chain trading' to capture more natural user queries.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'typed wrapper over the SushiSwap API', 'token amounts, prices, quotes, swap transaction generation', 'safer arithmetic, formatting, and comparisons', 'request swap quotes or executable swap transactions'. These are concrete, actionable capabilities.	3 / 3
Completeness	Clearly answers both 'what' (TypeScript SDK for SushiSwap Aggregator with typed primitives for token amounts, quotes, swap transactions) and 'when' with an explicit 'USE THIS SKILL WHEN' clause listing five specific trigger conditions.	3 / 3
Trigger Term Quality	Includes relevant terms like 'TypeScript', 'SDK', 'SushiSwap', 'swap quotes', 'token amounts', but misses common user variations like 'DeFi', 'DEX aggregator', 'token swap', 'crypto trading', 'liquidity'. The terms are somewhat technical and may not cover all natural phrasings a user might employ.	2 / 3
Distinctiveness Conflict Risk	Highly distinctive due to the specific domain (SushiSwap Aggregator SDK) and the combination of TypeScript + DeFi swap primitives. Very unlikely to conflict with other skills given the narrow, well-defined niche.	3 / 3
	Total	11 / 12 Passed

Implementation

57%

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

The skill is well-structured with good progressive disclosure, deferring detailed examples to a reference file. However, the main content lacks concrete, executable code examples for the core SDK operations (getQuote/getSwap), which significantly limits actionability. Some sections are more verbose than necessary for Claude's level of understanding.

Suggestions

Add at least one complete, executable code example showing a `getQuote()` or `getSwap()` call with all required parameters filled in, rather than just listing abstract steps.

Consolidate the installation section to a single command (e.g., just `pnpm add sushi viem`) since Claude can adapt to any package manager.

Add a concrete validation/error handling example showing what to do when chainId is unsupported or when the API returns an error, to improve workflow clarity.

Dimension	Reasoning	Score
Conciseness	The content includes some unnecessary verbosity — listing four package managers for installation is redundant for Claude, and the explanations around referrer and fee customization are somewhat padded. The supported networks section over-explains what to do if a chain isn't supported.	2 / 3
Actionability	The skill provides installation commands and mentions `getQuote()` and `getSwap()` but never shows executable code examples for actually calling these functions with parameters. The 'How To Use' section is a numbered list of abstract instructions rather than concrete, copy-paste-ready code.	2 / 3
Workflow Clarity	The 'How To Use' section provides a numbered sequence with validation guidance (check chainId, validate inputs), but lacks explicit validation checkpoints, error handling steps, or feedback loops. The workflow is more of a checklist than a clear step-by-step process with verification.	2 / 3
Progressive Disclosure	The skill provides a clear overview with well-organized sections and appropriately defers detailed SDK examples and execution flow to a single reference file (references/REFERENCE.md). Navigation is one level deep and clearly signaled.	3 / 3
	Total	9 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: Demerzels-lab/elsamultiskillagent
Commit: 45f9fac

Reviewed: 2 months ago

Table of Contents

Discovery Implementation Validation

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.