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

78%

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

100%

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 specific capabilities (token primitives, swap quotes, transaction generation, safe arithmetic), and provides explicit trigger conditions via a 'USE THIS SKILL WHEN' clause. The description is well-structured, uses third person voice appropriately, and contains natural keywords that developers would use when seeking this functionality.

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 tokens, quotes, swaps) and 'when' (explicit 'USE THIS SKILL WHEN' clause with five specific trigger conditions covering TypeScript apps, typed primitives, swap quotes, safer arithmetic, and SDK preference).	3 / 3
Trigger Term Quality	Includes strong natural keywords users would say: 'TypeScript', 'JavaScript', 'SushiSwap', 'swap quotes', 'swap transactions', 'SDK', 'token amounts', 'floating point', 'API'. Good coverage of terms a developer working with SushiSwap would naturally use.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with a clear niche: SushiSwap-specific SDK for DeFi swap operations in TypeScript. The combination of 'SushiSwap', 'Aggregator', 'swap quotes', and 'typed token primitives' makes it very unlikely to conflict with other skills.	3 / 3
	Total	12 / 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 and clear organization, but falls short on actionability by not including any executable code examples in the main file — the core SDK usage (getQuote/getSwap calls) is entirely deferred to the reference. Conciseness could be improved by trimming redundant installation variants and tightening explanatory prose that Claude doesn't need.

Suggestions

Add at least one complete, executable code example showing a getQuote() or getSwap() call with all required parameters, so the main skill file is independently actionable.

Consolidate the four package manager installation commands into one (e.g., just pnpm) with a brief note that other managers work equivalently — Claude doesn't need all four spelled out.

Add explicit validation/error handling steps to the workflow, e.g., 'If chainId is not in SWAP_API_SUPPORTED_CHAIN_IDS, return an error message to the user' with a code snippet.

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. However, it's not egregiously verbose and most sections carry useful information.	2 / 3
Actionability	The skill provides installation commands and mentions specific function names (getQuote, getSwap) and imports, but lacks any executable code examples showing actual usage — no complete code snippet demonstrating a quote request or swap transaction. The real actionable content is deferred to the reference file.	2 / 3
Workflow Clarity	The 'How To Use' section provides a numbered sequence of steps, but validation is mentioned only as a bullet point ('Validate inputs') without specifying how to validate or what to do on failure. There are no explicit feedback loops or error recovery steps for the swap execution workflow.	2 / 3
Progressive Disclosure	The skill provides a clear overview with well-organized sections and a single, clearly signaled reference to a detailed file (references/REFERENCE.md) for examples and execution flow. The structure is appropriate — overview content stays in the main file, detailed examples are one level deep.	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: about 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.