Track crypto options flow to identify institutional positioning and market sentiment. Use when tracking institutional options flow. Trigger with phrases like "track options flow", "analyze derivatives", or "check institutional".
59
51%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/crypto/options-flow-analyzer/skills/analyzing-options-flow/SKILL.mdQuality
Discovery
67%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 adequately covers the what and when, earning strong completeness marks. However, it lacks depth in specific concrete actions and could benefit from more natural trigger term variations. The domain is reasonably distinct but some trigger phrases are generic enough to risk overlap with adjacent financial analysis skills.
Suggestions
Add more specific concrete actions such as 'monitor block trades, analyze put/call ratios, track open interest changes, identify whale positioning'
Expand trigger terms with natural user phrases like 'whale activity', 'smart money', 'options volume', 'put/call ratio', 'crypto derivatives flow'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (crypto options flow) and mentions some actions (track, identify institutional positioning and market sentiment), but doesn't list multiple concrete specific actions like analyzing Greeks, tracking block trades, monitoring open interest changes, etc. | 2 / 3 |
Completeness | Clearly answers both 'what' (track crypto options flow to identify institutional positioning and market sentiment) and 'when' (explicit trigger phrases and use-when clause provided). | 3 / 3 |
Trigger Term Quality | Includes some relevant trigger phrases like 'track options flow', 'analyze derivatives', and 'check institutional', but misses common natural variations users might say such as 'whale activity', 'large trades', 'put/call ratio', 'options volume', 'smart money', or 'crypto derivatives'. | 2 / 3 |
Distinctiveness Conflict Risk | The crypto options flow niche is fairly specific, but terms like 'analyze derivatives' and 'check institutional' are broad enough to potentially overlap with general crypto analysis or traditional finance derivatives skills. | 2 / 3 |
Total | 9 / 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 is well-structured in layout but suffers from significant verbosity—it explains many concepts Claude already understands (options terminology, what put/call ratios mean, IV term structure interpretation) and provides extensive output specifications that inflate token cost. The actionability is moderate: CLI examples are given but no actual executable code or API call implementations are provided, and the referenced implementation file doesn't exist in the bundle. The workflow lacks validation checkpoints between steps.
Suggestions
Remove explanations of options concepts Claude already knows (put/call ratio interpretation, IV term structure meaning, max pain definition) to cut token usage by ~40%.
Provide actual executable Python code for at least the core operations (API connection, options chain retrieval, put/call ratio calculation) rather than just CLI invocations for an unverified script.
Add explicit validation checkpoints in the workflow: verify API connection in step 1, confirm data completeness after step 2-3, validate statistical outputs before generating the report.
Move the detailed error handling table and extensive output specifications to a referenced file (e.g., `references/error-handling.md`) to keep the main skill lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose with extensive explanations of options concepts Claude already knows (put/call ratios, max pain, IV term structure). The error handling table, output section, and resources section are all padded well beyond what's necessary. The 'Understanding of options terminology' prerequisite is unnecessary for Claude. | 1 / 3 |
Actionability | The instructions reference specific CLI commands (e.g., `python options_flow.py btc --summary`) and bash patterns (`Bash(crypto:options-*)`), but no actual executable code is provided—just CLI invocations for a script that presumably exists somewhere. The steps are largely descriptive ('Calculate the aggregate put/call ratio') rather than providing concrete implementation code or API calls. | 2 / 3 |
Workflow Clarity | Steps are listed sequentially (1-10) but lack validation checkpoints. There's no feedback loop for verifying API connections succeed before proceeding, no checkpoint after data retrieval to confirm completeness, and no validation step before generating the final report. The error handling table exists but is separate from the workflow rather than integrated as checkpoints. | 2 / 3 |
Progressive Disclosure | References `${CLAUDE_SKILL_DIR}/references/implementation.md` for the full implementation workflow and `${CLAUDE_SKILL_DIR}/config/crypto-apis.env` for credentials, which is good structure. However, no bundle files are provided to support these references, and the SKILL.md itself contains a large amount of detail (extensive output specs, error tables, resources) that could be split into reference files. The main file is quite long for an overview. | 2 / 3 |
Total | 7 / 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 |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3a2d27d
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.