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-navigatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| trading-skills-navigator (this skill)by tradermonty | 90 | 2.9k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.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.
Skill content
View source on GitHubname: 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. Forambiguous, name everycandidate_personasentry and explain that the ordered first match was selected. Forfallback, 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: activemeans a curatedskillsets/<id>.yamlbundle ships for this category (market-regime, core-portfolio, swing-opportunity, trade-memory) โ mention it as the install bundle for the recommended workflow.manifest_status: deferredmeans 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_apiis the request flag โ whether no-API mode was active โ not whether the path is free; always narrateno_api_path.) If a workflow was excluded under--no-api, surface therationaleentry naming the paid integration (e.g. "swing-opportunity-daily needs FMP"). - Honest gap โ if
honest_gapis true there is no shipped workflow for this intent. Say so directly, then presentsuggested_skillsfrom the relevant category and relay thenote. Never invent a workflow. - Operational roles โ narrate the
operational_rolesentry for every skill in the setup bundle or honest-gap suggestion. Explain standalone rationale when present; keep enum values unchanged. - Always read the
rationalearray 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โ regeneratesassets/metadata_snapshot.jsonfrom the SSoT;--checkguards 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-apicredential 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; runbuild_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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
ruflo
81.9k๐ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio โ 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
