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

60%

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 TypeScript SDK), lists specific capabilities, and includes an explicit 'USE THIS SKILL WHEN' section with multiple trigger conditions. Its main weakness is that trigger terms could include more natural user language variations (e.g., 'DeFi', 'DEX', 'token swap') to improve discoverability. The description is well-structured and distinctive enough to avoid conflicts with other skills.

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, specific capabilities.	3 / 3
Completeness	Clearly answers both 'what' (TypeScript SDK for SushiSwap Aggregator with typed primitives for token amounts, quotes, and swap transactions) and 'when' (explicit 'USE THIS SKILL WHEN' clause with five specific trigger conditions). The when clause is explicit and well-structured.	3 / 3
Trigger Term Quality	Includes relevant terms like 'TypeScript', 'JavaScript', 'SushiSwap', 'swap quotes', 'SDK', 'token amounts', but misses common variations users might say like 'DEX aggregator', 'token swap', 'DeFi', 'liquidity', 'slippage', or 'on-chain trading'. The terms are somewhat technical and domain-specific but cover the core use case.	2 / 3
Distinctiveness Conflict Risk	Highly distinctive — targets a very specific niche (SushiSwap SDK in TypeScript) with clear domain-specific triggers like 'SushiSwap', 'swap quotes', 'swap transactions', and 'fraction primitives'. Unlikely to conflict with other skills unless there are multiple DeFi SDK skills.	3 / 3
	Total	11 / 12 Passed

Implementation

35%

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

This skill provides a reasonable structural overview of the SushiSwap SDK but critically lacks executable code examples for its core operations (getQuote, getSwap), making it largely non-actionable. The content is moderately concise but includes some padding (four installation variants, repeated emphasis on referrer). The referenced REFERENCE.md file is not available in the bundle, leaving the skill incomplete as a standalone guide.

Suggestions

Add complete, executable TypeScript examples for getQuote() and getSwap() with actual parameter objects, types, and expected return shapes — this is the most critical gap.

Consolidate the installation section to a single command (e.g., pnpm) with a brief note that other managers work equivalently, saving ~10 lines.

Include a concrete validation example showing how to check chainId against SWAP_API_SUPPORTED_CHAIN_IDS and handle the failure case with actual code.

Either provide the referenced REFERENCE.md bundle file or inline the essential execution flow examples directly in the skill.

Dimension	Reasoning	Score
Conciseness	The skill includes some unnecessary verbosity — listing four package managers for installation is redundant for Claude, and sections like 'Fee Customization' and 'Mandatory referrer Parameter' repeat points that could be condensed. The explanation that the SDK 'does not replace the API' is somewhat unnecessary padding. However, it's not egregiously verbose.	2 / 3
Actionability	The skill lacks any executable code examples for the core operations (getQuote, getSwap). It describes what to do abstractly ('Provide all required parameters exactly as defined by the SDK types') but never shows actual function signatures, parameter objects, or copy-paste-ready usage. The only concrete code is a single import statement for supported chain IDs.	1 / 3
Workflow Clarity	The 'How To Use' section provides a numbered sequence of steps, and there's mention of input validation and checking supported chains before proceeding. However, there are no explicit validation checkpoints, no error recovery feedback loops, and the steps remain abstract rather than showing concrete validation code or expected outputs.	2 / 3
Progressive Disclosure	The skill references 'references/REFERENCE.md' for detailed examples and execution flow, which is good structure. However, no bundle files were provided, so we can't verify the reference exists or is useful. The main file itself contains sections (like fee customization details) that could arguably be in the reference file, and the overview could be tighter with more content delegated.	2 / 3
	Total	7 / 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: f45fcb5

Reviewed: 12 days 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.