Skip to content
Back to search

trading-agents-skill

Moved to github.com/pyuan07/trading-skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pyuan07--trading-agents-skill/badge.svg)](/listings/pyuan07--trading-agents-skill)

HTML

<a href="/listings/pyuan07--trading-agents-skill"><img src="/api/listings/pyuan07--trading-agents-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Copy the skill folder into your skills directory:

| Tool | Location | |---|---| | Claude Code (all projects) | `~/.claude/skills/trading-agents/` | | Claude Code (one project) | `<project>/.claude/skills/trading-agents/` | | Codex | `<project>/.agents/skills/trading-agents/` |

   git clone https://github.com/pyuan07/trading-agents-skill
   cp -r trading-agents-skill/skills/trading-agents ~/.claude/skills/

2. Give the skill a way to run its Python scripts. **Easiest: install [uv](https://docs.astral.sh/uv/getting-started/installation/)** and you're done. Each script declares its own dependencies, and `uv run` fetches them automatically the first time.

Or, without uv, create the skill's own venv once (Python 3.10+):

   # macOS / Linux
   cd ~/.claude/skills/trading-agents
   python3 -m venv .venv && .venv/bin/python -m pip install -r scripts/requirements.txt
   # Windows
   cd $HOME\.claude\skills\trading-agents
   python -m venv .venv; .venv\Scripts\python.exe -m pip install -r scripts\requirements.txt

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 127 lines
  1. > **📦 Moved:** this skill now lives at **[pyuan07/trading-skills](https://github.com/pyuan07/trading-skills)**. This repository is archived and will not receive updates.
  2. # trading-agents — a multi-agent stock analysis skill
  3. An agent skill for **Claude Code** (and other tools that load `SKILL.md` skills, such as Codex) that runs the [TradingAgents](https://github.com/TauricResearch/TradingAgents) methodology inside your coding agent:
  4. ```
  5. analysts (fundamentals · technical · news/sentiment)
  6. → bull vs bear debate
  7. → trader plan
  8. → risk debate (aggressive · conservative · neutral)
  9. → portfolio manager: BUY / ADD / HOLD / TRIM / SELL + size, stop, target
  10. ```
  11. It is **portfolio-aware**: give it your holdings and it judges the ticker against your real book (concentration, sector weights, correlation, margin, options exposure, your risk profile). It also keeps a **decisions ledger** that grades every past call against SPY at 30 and 180 days, and shows that track record to the agents the next time you analyze the same ticker.
  12. > ⚠️ **Decision support, not financial advice.** LLM output can be wrong, and market data can be stale or missing. Verify everything before trading. This skill never places orders.
  13. ## What you get
  14. - `reports/YYYY-MM-DD-TICKER.md`: the full report, with every stage's reasoning and a decision summary.
  15. - `reports/ledger.md`: one row per call, graded automatically as each horizon matures.
  16. - Deterministic Python for the number-crunching (indicators, FX, concentration, ledger math), so the LLM spends its tokens on judgment.
  17. **See a full example:** [`docs/sample-report-MSFT.md`](docs/sample-report-MSFT.md). It's a complete run in which the analysts debate, the risk team argues over position size, and the portfolio manager trims an oversized position back under the 20% cap.
  18. ## Install
  19. 1. Copy the skill folder into your skills directory:
  20. | Tool | Location |
  21. |---|---|
  22. | Claude Code (all projects) | `~/.claude/skills/trading-agents/` |
  23. | Claude Code (one project) | `<project>/.claude/skills/trading-agents/` |
  24. | Codex | `<project>/.agents/skills/trading-agents/` |
  25. ```bash
  26. git clone https://github.com/pyuan07/trading-agents-skill
  27. cp -r trading-agents-skill/skills/trading-agents ~/.claude/skills/
  28. ```
  29. 2. Give the skill a way to run its Python scripts. **Easiest: install [uv](https://docs.astral.sh/uv/getting-started/installation/)** and you're done. Each script declares its own dependencies, and `uv run` fetches them automatically the first time.
  30. Or, without uv, create the skill's own venv once (Python 3.10+):
  31. ```bash
  32. # macOS / Linux
  33. cd ~/.claude/skills/trading-agents
  34. python3 -m venv .venv && .venv/bin/python -m pip install -r scripts/requirements.txt
  35. ```
  36. ```powershell
  37. # Windows
  38. cd $HOME\.claude\skills\trading-agents
  39. python -m venv .venv; .venv\Scripts\python.exe -m pip install -r scripts\requirements.txt
  40. ```
  41. ## Use
  42. Work from any folder you like. That folder becomes the skill's workspace: the skill reads your holdings from it and writes `work/` and `reports/` into it.
  43. ```
  44. analyze NVDA
  45. should I trim MSFT?
  46. deep dive on 7203.T ← "deep dive" / "full pipeline" runs every stage as its own subagent
  47. review my portfolio ← screens all holdings, then you pick which ones get a full run
  48. ```
  49. ### Optional: your portfolio
  50. Put these files in your working folder. Templates are in `skills/trading-agents/examples/`.
  51. - **`holdings.csv`**: one row per position. Only `ticker` and `qty` are required:
  52. ```csv
  53. ticker,name,qty,price,cost,market_value,currency,account,margin
  54. AAPL,Apple Inc.,50,230.00,180.00,11500.00,USD,brokerage,no
  55. 7203.T,Toyota Motor,100,2800,2500,280000,JPY,brokerage,no
  56. ```
  57. - Use Yahoo Finance symbols (`7203.T`, `ES3.SI`, `0700.HK`). OCC option symbols (`SPY270115P00500000`) are detected automatically and treated as exposure context.
  58. - Several files (`holdings-ira.csv`, `holdings-taxable.csv`) are merged.
  59. - **moomoo / Futu users:** drop the position export (`持仓-<account>(<id>)-<timestamp>.csv`) into the folder as-is. It's read natively.
  60. - **`portfolio-profile.json`**: `risk_tolerance`, `max_position_pct`, `margin_comfort`, `horizon`, and free-text `notes` that the portfolio manager must respect.
  61. Without either file the skill still works. It just analyzes the ticker without reference to a portfolio.
  62. ### moomoo users: live positions and extra research (optional)
  63. If the **moomoo MCP** is connected to your agent, the skill uses it automatically, and you don't need a CSV:
  64. | From moomoo | Used for |
  65. |---|---|
  66. | `account_positions` (all your securities accounts) | Live holdings, including short positions and options, instead of a CSV export |
  67. | `quote_research_analyst_consensus` | Analyst rating mix and target-price range, passed to the fundamentals analyst |
  68. | `quote_short_interest` | Short-interest trend and days to cover, passed to the fundamentals and news analysts |
  69. | `quote_unusual_capital` (optional) | Unusual capital and short-selling activity, passed to the news analyst |
  70. The skill only **reads** from moomoo. Its instructions forbid calling any order, trade, cancel or modify tool. If the MCP isn't connected, or a market isn't covered by your data permissions, the skill quietly falls back to `holdings.csv` and Yahoo.
  71. Price history and indicators still come from Yahoo, so the skill works the same for everyone, moomoo customer or not.
  72. ### Run depth and cost
  73. | Depth | What runs | When |
  74. |---|---|---|
  75. | **lite** (default) | Scripts, plus subagents for 2 analysts and the bull/bear debate. Trader, risk and PM are written inline by the orchestrator. | Everyday use |
  76. | **full** | Every stage is a separate subagent | Ask for a "full pipeline" or "deep dive" |
  77. ## Data sources
  78. - **Yahoo Finance via [yfinance](https://github.com/ranaroussi/yfinance)**: prices, fundamentals, headlines, FX. It's free and needs no key. It is an unofficial API, so it's subject to Yahoo's terms and occasional breakage, and the skill falls back to web lookups when it fails.
  79. - **Web search** for context such as why a stock moved and breaking news.
  80. - **moomoo MCP** (optional): live positions and research data, as described above.
  81. - **Alpha Vantage MCP** (optional): used sparingly if you have it connected.
  82. All values are normalized to **USD**, and the benchmark is **SPY**.
  83. ## Development
  84. ```bash
  85. cd skills/trading-agents/scripts
  86. pip install -r requirements-dev.txt
  87. pytest -q # offline: yfinance is faked in tests
  88. ```
  89. ## Credits and license
  90. This project adapts the methodology and agent roles of [TradingAgents](https://github.com/TauricResearch/TradingAgents) (Tauric Research, Apache-2.0). See [NOTICE](NOTICE). It is released under the [Apache License 2.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.