CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

trading-skills-navigator

Recommend the right trading workflow, skillset, API profile, and setup path from a natural-language goal. Use this as the on-ramp when a user expresses a trading or investing goal and needs to know which skill/workflow to use, where to start, or whether something works without paid API keys — e.g. "where do I start", "which skill should I use", "I want to swing trade only when the market is favorable", "what works without API keys", "どれを使えばいい", "API キー無しで 使えるものは". Routes and explains only; it never executes trades or auto-runs other skills, and it is honest when no workflow has shipped yet.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

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

The body is a well-structured operating manual: a deterministic 5-step workflow, an executable recommender command, thorough edge-case narration rules, and a genuinely real, well-indexed bundle. Its main costs are token efficiency — substantial duplication between the Step 3 bullets and the Output Format table — and the absence of a worked example and script-failure handling that would make the guidance fully copy-paste complete.

Suggestions

De-duplicate field semantics: keep the Output Format table as the single field reference and have the Step 3 bullets cross-reference it instead of re-explaining no_api_path, honest_gap, and dropped_secondary_workflows; split the overloaded honest-gap bullet into shorter sub-bullets.

Move the 16-row Output Format table (or the detailed narration rules) into a references/ file and keep a short field summary inline, so SKILL.md reads as an overview with one-level-deep pointers.

Add a worked example — one sample query, the JSON the script returns, and the expected conversational narration — plus one line on what to do if recommend.py fails or returns unexpected JSON; this lifts both actionability and workflow feedback coverage.

DimensionReasoningScore

Conciseness

There is no conceptual padding (nothing explains things Claude already knows), but the body duplicates field semantics between Step 3 narration bullets and the Output Format table — e.g. `no_api_path` handling and `dropped_secondary_workflows` are fully explained in both places — and the honest-gap bullet crams disclaimers ("Eligibility does not establish ownership, completeness, freshness or suitability for trading") into a single run-on block. Mostly efficient but could be meaningfully tightened, which matches anchor 3 rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Step 2 gives a copy-paste-ready command ("python3 skills/trading-skills-navigator/scripts/recommend.py --query ... --format json") with documented flags, and Step 3/4 give field-by-field narration and install instructions. It falls short of anchor 5 because there is no worked example (sample query → JSON output → expected narration) and the script path is only given for the repo layout, with no guidance for invoking it in the Web App environment the skill itself says has no repo root.

4 / 5

Workflow Clarity

Five clearly sequenced steps with explicit edge-case recovery: "For `ambiguous`, name every `candidate_personas` entry...", "For `fallback`, state that no persona matched and ask the user to rephrase", and "never present the beginner fallback as an exact intent match". It stops short of anchor 5 because there is no checkpoint for script-level failure (what to do if recommend.py errors or emits unexpected JSON), leaving a minor validation gap.

4 / 5

Progressive Disclosure

All referenced bundle files exist and are one level deep, the Resources section indexes every script/reference/asset with a purpose line, and heavy material is properly externalized (persona table → references/intent_routing.md, setup steps → references/setup_paths.md, corpus → assets/). It is not anchor 5 because the body inlines a 16-row field table and very dense narration rules that partially duplicate the reference material and could be split out.

4 / 5

Total

15

/

20

Passed

Description

95%Weight 40%Scale 1-5

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

A strong description: it states concrete deliverables, gives an explicit 'Use when...' clause with natural bilingual trigger phrases, and draws sharp boundaries against execution skills. The only minor weakness is that the action vocabulary (recommend/route/explain) stays at the recommendation level rather than enumerating more granular operations.

DimensionReasoningScore

Specificity

Concrete deliverables are enumerated — "Recommend the right trading workflow, skillset, API profile, and setup path" plus "Routes and explains only" — giving several specific actions with minor gaps. It does not reach anchor 5 because the action verbs themselves are few (recommend/route/explain) and coverage is at the recommendation level rather than a comprehensive list of concrete operations.

4 / 5

Completeness

Explicitly answers both questions: what ("Recommend the right trading workflow, skillset, API profile, and setup path from a natural-language goal") and when ("Use this as the on-ramp when a user expresses a trading or investing goal and needs to know which skill/workflow to use, where to start...") with concrete trigger phrases. Both are clearly and explicitly stated, matching anchor 5; it is not anchor 4 since the 'when' clause is fully specific, not merely present.

5 / 5

Trigger Term Quality

Includes natural user phrases with synonyms across two languages: "where do I start", "which skill should I use", "what works without API keys", "I want to swing trade only when the market is favorable", "どれを使えばいい", "API キー無しで使えるものは". This comprehensively covers the natural terms a user would say for this routing need, matching the top anchor; no meaningful trigger variation is missing.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear router niche with explicit boundaries — "Routes and explains only; it never executes trades or auto-runs other skills" — which actively distinguishes it from execution skills, and its triggers are routing-specific questions. Minimal conflict risk; anchor 5 is the best fit, not anchor 4, because the disclaimers remove the main overlap risk with trade-execution skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tradermonty/claude-trading-skills

Path

skills/trading-skills-navigator/SKILL.md

Reviewed

Table of Contents

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.