SkillAgentSearch skills...

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.

Install / Use

npx skills add tradermonty/claude-trading-skills --skill trading-skills-navigator

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

90/100

Category

Automation

Supported Platforms

Universal

Our assessment of trading-skills-navigator

trading-skills-navigator scores 90/100 on our quality scale, 1205th of 2,780 Automation skills we index (top 44%).

Its SKILL.md is 8.6 KB long, well organised into 10 sections with 1 code example: a thorough specification that gives an agent plenty to work with.

With 2,885 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
17/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so trading-skills-navigator is actively maintained.
  • Our last check on 2026-10-30 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

trading-skills-navigator compared with similar skills

All 4 of these similar skills score higher than trading-skills-navigator; compare them before choosing.

SkillScoreStarsUpdatedFormat
trading-skills-navigator (this skill)by tradermonty902.9k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k9d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install trading-skills-navigator?
Run npx skills add tradermonty/claude-trading-skills --skill trading-skills-navigator. The install tabs above show the steps for each supported agent.
Which AI agents does trading-skills-navigator work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is trading-skills-navigator safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is trading-skills-navigator still maintained?
The repository was last updated about 2 months ago, so trading-skills-navigator is actively maintained.

name: trading-skills-navigator description: >- 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.

Trading Skills Navigator

The interactive on-ramp for this repository. It turns a user's goal into a concrete recommendation: which workflow to run, which skillset (skills-index category) it belongs to, the API requirement, and the setup path for Claude Web App or Claude Code.

A new user faces 74 skills + 11 workflows with no router. This skill is that router. It is deterministic โ€” a Python recommender (scripts/recommend.py) consumes the repo metadata; this SKILL.md narrates the result conversationally.

When to Use

  • The user expresses a trading/investing goal and asks where to start or which skill/workflow to use ("ใฉใ‚Œใ‚’ไฝฟใˆใฐใ„ใ„", "where do I start").
  • The user asks what works without paid API keys.
  • The user wants the no-API vs API path separated, or a beginner path.
  • The user describes a persona ("part-time swing trader", "dividend investor", "I want to short", "I want to backtest ideas") and needs routing.

Do not use this skill to execute trades, place orders, or auto-run other skills. It recommends and explains only.

Workflow

Step 1 โ€” Capture the goal and constraints

From the user's message, extract:

  • The natural-language goal (verbatim is fine).
  • Optional constraints: no-API only? a daily time budget (15m/30m/60m/90m)? experience level (beginner/intermediate/advanced)?

Ask at most one brief clarifying question only if the goal is empty or has no discernible intent. Otherwise proceed โ€” the recommender degrades gracefully.

Step 2 โ€” Run the recommender

python3 skills/trading-skills-navigator/scripts/recommend.py \
  --query "<the user's goal, verbatim>" \
  --format json
  # optional: --no-api  --time-budget 15m|30m|60m|90m|any
  #           --experience beginner|intermediate|advanced
  • In Claude Code the script reads the repo-root SSoT (skills-index.yaml + workflows/*.yaml) automatically.
  • In the Claude Web App there is no repo root; the script transparently falls back to the bundled assets/metadata_snapshot.json. The recommendation is byte-identical in both environments โ€” no behavior change for the user.

Step 3 โ€” Narrate the result conversationally

Parse the JSON and explain, in the user's language:

  • Primary workflow โ€” display_name, cadence, ~estimated_minutes, api_profile. State plainly what it does and when to run it.
  • Routing diagnostics โ€” read routing_diagnostics.status. For ambiguous, name every candidate_personas entry and explain that the ordered first match was selected. For fallback, state that no persona matched and ask the user to rephrase; never present the beginner fallback as an exact intent match.
  • Secondary workflows โ€” if any, how they relate (e.g. "run the regime check first, then this when it allows risk").
  • Skillset โ€” the skillset.id (skills-index category). manifest_status: active means a curated skillsets/<id>.yaml bundle ships for this category (market-regime, core-portfolio, swing-opportunity, trade-memory) โ€” mention it as the install bundle for the recommended workflow. manifest_status: deferred means no manifest yet (e.g. honest-gap categories); the recommendation is workflow-based only.
  • No-API vs API โ€” read no_api_path: true โ†’ the entire recommended path works without paid API keys (state this plainly); false โ†’ tell the user which paid key(s) the path needs; null โ†’ honest gap, no path. (no_api is the request flag โ€” whether no-API mode was active โ€” not whether the path is free; always narrate no_api_path.) If a workflow was excluded under --no-api, surface the rationale entry naming the paid integration (e.g. "swing-opportunity-daily needs FMP").
  • Honest gap โ€” if honest_gap is true there is no shipped workflow for this intent. Say so directly, then present suggested_skills from the relevant category and relay the note. Never invent a workflow.
  • Operational roles โ€” narrate the operational_roles entry for every skill in the setup bundle or honest-gap suggestion. Explain standalone rationale when present; keep enum values unchanged.
  • Always read the rationale array and explain why this was recommended.

Step 4 โ€” Explain the setup path

Read references/setup_paths.md and walk the user through installing setup_bundle โ€” the recommender's deterministic install union over the primary skillset and every secondary workflow (so nothing is dropped for a multi-workflow recommendation). Enumerate setup_bundle.required โ†’ recommended โ†’ optional, cite setup_bundle.sources to explain why each skill is needed, and name skillset.manifest.related_workflows for how the bundle is run. Narrate skillset.manifest (when present) as "what the recommended skillset is". On an honest gap install suggested_skills. Do this for whichever environment the user is in (Claude Web App .skill upload, or Claude Code folder copy); call out any paid API keys those skills need.

Step 5 โ€” Point to the learning loop

Close by pointing the user at trader-memory-core and the trade-memory-loop / monthly-performance-review workflows so every recommended path feeds the Plan โ†’ Trade โ†’ Record โ†’ Review โ†’ Improve loop.

Output Format

The JSON the recommender emits (stable, idempotent, sort_keys):

| Field | Meaning | |---|---| | primary_workflow | Recommended workflow object, or null on an honest gap | | secondary_workflows | Supporting workflows (ordered, time-budget filtered) | | skillset | {id, source: skills-index.category, manifest_status, manifest}. manifest_status is active when skillsets/<id>.yaml ships, else deferred. manifest is the 5-key view {display_name, required_skills, recommended_skills, optional_skills, related_workflows} when active, else null. Describes the primary skillset only โ€” not the install list | | setup_bundle | {required, recommended, optional, sources} โ€” the actionable install union over the primary skillset and every secondary workflow (deterministic, tier-deduped). This is what to install. All-empty on an honest gap (use suggested_skills) | | suggested_skills | Skills to use when no workflow shipped (honest gap); else [] | | operational_roles | Skill id โ†’ {type, rationale?} for every setup-bundle skill, or every suggested_skills item on an honest gap | | no_api | Request-side: was no-API constraint mode active (flag or persona) | | no_api_path | Path-side: does the whole recommendation (primary + every secondary) work without paid API keys? true/false; null on an honest gap. This is the DoD's API-vs-no-API separation โ€” narrate it explicitly | | honest_gap | true when no workflow exists for the intent | | note | Plain-language explanation for gaps / unmapped input | | rationale | Ordered list of why-this-was-recommended strings | | routing_diagnostics | {status, selected_persona, candidate_personas, explanation}. status is exact, ambiguous, or fallback; candidates are all pre-constraint persona matches in deterministic order | | setup_path_ref | Pointer to the setup-path reference |

Resources

  • scripts/recommend.py โ€” the deterministic recommender (single source of truth for routing).
  • scripts/build_snapshot.py โ€” regenerates assets/metadata_snapshot.json from the SSoT; --check guards drift (pre-commit + CI).
  • scripts/intent_benchmark.py โ€” validates the fail-closed bilingual routing corpus, persona shadowing contracts, and metamorphic invariants.
  • references/intent_routing.md โ€” the persona table, the 10-question contract, the --no-api credential rule, and scoring tie-breaks.
  • references/setup_paths.md โ€” Claude Web App vs Claude Code setup steps.
  • assets/metadata_snapshot.json โ€” generated SSoT digest for the Web App fallback. Never edit by hand; run build_snapshot.py.
  • assets/intent_benchmark_v1.json โ€” 211 explicitly labeled EN/JA routing cases with 1.0 precision/recall and per-persona/workflow coverage gates.

Related Skills

View on GitHub
GitHub Stars2.9k
CategoryAutomation
Updated1mo ago
Forks655

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

No cautions
trading-skills-navigator โ€” Universal Skill: Install & Safety Check | SkillAgent