orca

Orca Whirlpools - concentrated liquidity on Solana

Quality

30%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./src/skills/bundled/orca/SKILL.md

Quality

Content

37%

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

This skill is extremely concise but lacks the substance needed to be useful. It reads more like a command reference stub than an actionable skill—there's no implementation guidance, no code for executing swaps or fetching quotes, and no workflow for handling the multi-step process of Solana transactions. Financial operations especially need validation checkpoints and error handling.

Suggestions

Add executable code examples showing how to actually perform a swap using the Orca Whirlpools SDK (e.g., @orca-so/whirlpools-sdk), including wallet setup, quote fetching, and transaction submission.

Define a clear multi-step workflow for swaps: get quote → validate slippage → build transaction → sign → submit → confirm, with error handling at each step.

Include essential configuration details: RPC endpoints, required dependencies, token mint addresses or how to look them up, and slippage/fee parameters.

Reference external documentation or additional files for advanced topics like position management, liquidity provision, and pool creation.

Dimension	Reasoning	Score
Conciseness	Very lean and efficient. The one-line description of Orca is genuinely useful context (Solana DEX, concentrated liquidity) without over-explaining. Every token earns its place.	3 / 3
Actionability	The skill lists command syntax but provides no concrete implementation details—no code, no SDK references, no RPC endpoints, no wallet setup, no transaction construction. Claude wouldn't know how to actually execute these commands.	1 / 3
Workflow Clarity	There is no workflow described. Swaps on Solana involve multiple steps (wallet connection, quote fetching, transaction building, signing, confirmation) and none of these are sequenced or validated. For a destructive financial operation, this is critically insufficient.	1 / 3
Progressive Disclosure	The content is well-organized with clear sections (Commands, Examples), but there are no references to additional resources, SDK documentation, or detailed guides that would be needed for actual implementation.	2 / 3
	Total	7 / 12 Passed

Description

22%

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 is essentially a tagline rather than a functional skill description. It identifies the domain (Orca Whirlpools on Solana) but fails to specify any concrete actions the skill performs and completely omits guidance on when Claude should select it. The niche domain name provides some distinctiveness, but the description is far too sparse to be effective for skill selection.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Creates and manages concentrated liquidity positions, swaps tokens, adjusts tick ranges, and harvests fees on Orca Whirlpools.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about Orca Whirlpools, concentrated liquidity pools on Solana, LP positions, providing liquidity, or interacting with Whirlpool smart contracts.'

Include common user-facing keywords and variations such as 'liquidity pool', 'LP', 'swap', 'DeFi', 'AMM', 'tick range', and 'fee harvesting' to improve trigger term coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ('Orca Whirlpools', 'concentrated liquidity', 'Solana') but does not describe any concrete actions. There are no verbs indicating what the skill actually does—no 'create pools', 'manage positions', 'swap tokens', etc.	1 / 3
Completeness	The description only vaguely addresses 'what' (concentrated liquidity on Solana) without specifying concrete capabilities, and completely lacks any 'when' clause or explicit trigger guidance. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also very weak, so this scores a 1.	1 / 3
Trigger Term Quality	It includes some relevant keywords a user might say ('Orca', 'Whirlpools', 'concentrated liquidity', 'Solana'), but misses many natural variations like 'LP', 'liquidity pool', 'swap', 'DeFi', 'position management', 'tick range', or 'AMM'.	2 / 3
Distinctiveness Conflict Risk	The mention of 'Orca Whirlpools' is fairly specific and niche, which helps distinguish it from generic DeFi or Solana skills. However, the lack of concrete actions means it could still overlap with other Solana DeFi or liquidity-related skills.	2 / 3
	Total	6 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: alsk1992/CloddsBot
Path: src/skills/bundled/orca/SKILL.md
Commit: e71a5f6

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