Skip to content
Back to search

trader-skill

MarketplaceWorks with Claude CodeGitHub

The Trader skill pack for Claude

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/jakeschincariol--trader-skill/badge.svg)](/listings/jakeschincariol--trader-skill)

HTML

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

Install

Install instructions from the README

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

Paste this into Claude:

https://github.com/Jakeschincariol/trader-skill

install skill

Or as a plugin, in Claude Code:

/plugin marketplace add Jakeschincariol/trader-skill
/plugin install trader-skill@trader-skill

Claude Code namespaces plugin skills, so installed as a plugin they show up as `/trader-skill:trader-copycat` and so on. Copy the folders instead if you want plain `/trader-copycat`:

git clone https://github.com/Jakeschincariol/trader-skill.git
cp -r trader-skill/trader-* ~/.claude/skills/

Project-local instead of global: copy the same folders into your repo's `.claude/skills/`. No Claude Code at all? Paste any single `SKILL.md` at the top of a chat and it runs as a mode. You lose the Python tools, but the method works.

The tools need Python 3.8 or newer. Nothing to pip install. SEC asks every script to identify itself: put your name and email in `trader/config.json` (`"sec_user_agent": "Your Name you@example.com"`) or in the `SEC_USER_AGENT` environment variable.

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.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "trader-skill",
  4. "description": "The Trader skill pack for Claude",
  5. "owner": {
  6. "name": "Jake Schincariol",
  7. "url": "https://opusjake.ai"
  8. },
  9. "plugins": [
  10. {
  11. "name": "trader-skill",
  12. "description": "Eleven Claude skills for investing: copy a famous investor's 13F, watch the news, size trades to your budget, track Congress's stock disclosures, read earnings, screen, check risk, place approved orders, harvest tax losses, price alerts and rebalancing.",
  13. "source": "./",
  14. "category": "productivity",
  15. "homepage": "https://github.com/Jakeschincariol/trader-skill"
  16. }
  17. ]
  18. }
README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # The Trader skill
  2. 11 Claude skills that copy the investors you trust, watch the news and Congress, size every trade to your budget, and never place an order without your yes.
  3. Free, MIT, no signup, no API key. The tools are plain Python that read public
  4. data: SEC EDGAR, the House Clerk, news feeds.
  5. One reverse-engineers the investor you want to copy, straight from their 13F
  6. filing. Another monitors breaking news on every stock you hold. One manages your
  7. budget: every dollar sized, a cash buffer kept, no stock over your cap. And the
  8. craziest one is the Pelosi skill: it reads the stock trades members of Congress
  9. disclose, the minute the filing posts.
  10. And no trade goes through until you say yes. Nothing in this pack can place an
  11. order on its own. Paper trading is the default.
  12. ## Install
  13. Paste this into Claude:
  14. ```
  15. https://github.com/Jakeschincariol/trader-skill
  16. install skill
  17. ```
  18. Or as a plugin, in Claude Code:
  19. ```
  20. /plugin marketplace add Jakeschincariol/trader-skill
  21. /plugin install trader-skill@trader-skill
  22. ```
  23. Claude Code namespaces plugin skills, so installed as a plugin they show up as
  24. `/trader-skill:trader-copycat` and so on. Copy the folders instead if you want
  25. plain `/trader-copycat`:
  26. ```bash
  27. git clone https://github.com/Jakeschincariol/trader-skill.git
  28. cp -r trader-skill/trader-* ~/.claude/skills/
  29. ```
  30. Project-local instead of global: copy the same folders into your repo's
  31. `.claude/skills/`. No Claude Code at all? Paste any single `SKILL.md` at the
  32. top of a chat and it runs as a mode. You lose the Python tools, but the method
  33. works.
  34. The tools need Python 3.8 or newer. Nothing to pip install. SEC asks every
  35. script to identify itself: put your name and email in `trader/config.json`
  36. (`"sec_user_agent": "Your Name you@example.com"`) or in the `SEC_USER_AGENT`
  37. environment variable.
  38. ## The eleven
  39. | command | job | what it does |
  40. | --- | --- | --- |
  41. | `/trader-copycat` | Reverse Engineer | Reads an investor's 13F-HR on SEC EDGAR and rebuilds their portfolio as weights you can copy, with what they bought, added, trimmed and sold since last quarter. |
  42. | `/trader-news` | News Monitor | Watches headlines and SEC filings (8-Ks) for every stock you hold and flags what touches them. |
  43. | `/trader-budget` | Budget Manager | Sizes every position to your budget, keeps a cash buffer and caps any one stock. |
  44. | `/trader-pelosi` | Pelosi Tracker | Reads Congress's stock-trade disclosures (House PTRs) as soon as they post, turns each PDF into clean rows and alerts you once per new filing. |
  45. | `/trader-analyst` | Earnings Analyst | Pulls each company's reported numbers from SEC XBRL (revenue, net income, diluted EPS, margins, growth) and its latest earnings release. |
  46. | `/trader-screener` | Stock Screener | Screens companies against your own rules and ranks what passes. |
  47. | `/trader-risk` | Risk Manager | Checks every proposed order against your limits and blocks anything over them. |
  48. | `/trader-broker` | Order Executor | Turns an approved order into the exact ticket your brokerage connector receives, and records your yes. It never places anything itself. |
  49. | `/trader-tax` | Tax Optimizer | Tracks cost-basis lots, gains and losses, tax-loss harvesting candidates and wash sales. |
  50. | `/trader-alerts` | Price Alerts | Rings when a price target, a stop or the opening bell hits, with the real NYSE calendar. |
  51. | `/trader-rebalance` | Rebalancer | Brings the portfolio back to its target weights when it drifts past your band. |
  52. ## How to use it
  53. Everything lands in a `trader/` folder in your project, and each skill reads
  54. what the last one wrote:
  55. ```
  56. copycat -> budget -> risk -> broker (copy an investor)
  57. news / pelosi / alerts (watch, on a schedule)
  58. analyst -> screener -> budget -> risk -> broker (pick your own)
  59. rebalance / tax -> risk -> broker (maintain)
  60. ```
  61. An example: copying Berkshire Hathaway with $5,000.
  62. 1. **`/trader-copycat`** "copy Berkshire's top 5". It finds Berkshire Hathaway
  63. (CIK 1067983), downloads its latest 13F-HR (Q2 2026, filed 2026-08-14) and
  64. reads every row: Apple 22.04 % of the reported portfolio, American Express
  65. 17.14 %, Alphabet 12.62 % (both share classes), Coca-Cola 10.86 %, Bank of
  66. America 9.20 %. Since last quarter: new D.R. Horton, sold out of
  67. Constellation Brands. It writes `trader/targets.json`, the top 5
  68. renormalised: 30.67 / 23.85 / 17.56 / 15.11 / 12.80 %.
  69. 2. **`/trader-budget`** with a $5,000 budget, a 10 % cash buffer and a 25 %
  70. cap: Apple $1,250 (capped), American Express $1,119, Alphabet $823,
  71. Coca-Cola $708, Bank of America $600, $500 cash, $0 idle. It writes
  72. `trader/orders.json` as proposals.
  73. 3. **`/trader-risk`** checks all five against your limits: blocked tickers,
  74. order size, position size after the fill, the cash buffer, no options or
  75. margin. PASS or BLOCK, with the reason.
  76. 4. **`/trader-broker`** shows you each ticket: "Buy $1,250 of AAPL, market,
  77. day". You type yes for that exact order. Claude calls your brokerage
  78. connector (Alpaca's MCP server, paper account by default), and Claude's own
  79. "Allow once / Deny" card asks you one more time.
  80. 5. On a schedule: **`/trader-news`** flags headlines on what you hold,
  81. **`/trader-pelosi`** alerts you when a new disclosure posts, and
  82. **`/trader-alerts`** rings on your price levels.
  83. 6. Every quarter: **`/trader-copycat`** diffs the new 13F against the last one,
  84. and **`/trader-rebalance`** proposes the trades to match it again.
  85. ## The tools
  86. All standard-library Python. The data tools read public endpoints and are
  87. polite about it (SEC's rule: identify yourself, at most 10 requests a second).
  88. ```bash
  89. python3 trader-copycat/edgar13f.py find buffett # a filer's CIK
  90. python3 trader-copycat/edgar13f.py filings 1067983 # its 13F-HR filings
  91. python3 trader-copycat/edgar13f.py --help # holdings, diff, copy
  92. python3 trader-news/news.py --tickers AAPL AXP GOOGL KO BAC --hours 24 # headlines + 8-Ks
  93. python3 trader-pelosi/ptr.py index --member pelosi # her PTRs this year
  94. python3 trader-pelosi/ptr.py --help # new, fetch, parse
  95. python3 trader-analyst/facts.py AAPL # quarters, growth, EPS
  96. python3 trader-screener/screen.py trader/metrics.json --rules trader/rules.json
  97. python3 trader-budget/size.py --budget 5000 --write # -> trader/orders.json
  98. python3 trader-risk/check.py # PASS / BLOCK per order
  99. python3 trader-broker/ticket.py show # the tickets, READY or not
  100. python3 trader-tax/lots.py harvest --min-loss 100 # with wash-sale checks
  101. python3 trader-alerts/alerts.py clock # NYSE open or closed
  102. python3 trader-rebalance/rebalance.py --band 5 # the drift table
  103. ```
  104. ```bash
  105. python3 -m unittest discover -s tests -v
  106. ```
  107. The tests run offline, on small fixtures cut from the real filings: Berkshire's
  108. Q1 and Q2 2026 information tables, the House Clerk's 2026 index, real PTR text,
  109. real XBRL facts and feeds.
  110. ## Fine print
  111. **Not financial advice.** This is software that reads public data and does
  112. arithmetic. It does not know your situation, it cannot see the future, and
  113. copying an investor does not copy their results. You can lose money. Decide for
  114. yourself, and talk to a licensed professional if you need advice.
  115. **No trade goes through until you say yes.** Only `/trader-broker` can lead to
  116. an order, and only after `/trader-risk` passes that exact order and you type yes
  117. for it in the chat. Set your brokerage tool to "Needs approval" in Claude
  118. (Customize, Connectors, tool permissions), never "Always allow", so Claude's
  119. own "Allow once / Deny" card is a second check. No options, margin, short
  120. selling or leverage unless you turn them on.
  121. **Paper first.** `"paper": true` is the default in `config.example.json`, and
  122. Alpaca's MCP server defaults to its paper account. Keys live in environment
  123. variables, never in the chat.
  124. **13F data is old and partial.** Funds file 45 days after each quarter ends, and
  125. a 13F lists long positions in US-listed stocks and a few related securities:
  126. no shorts, no cash, no foreign-listed shares. You see what they held, not what they hold today.
  127. **Congress's trades are public, not inside information.** Members must disclose
  128. trades over $1,000 within 45 days (the STOCK Act). The Pelosi skill reads those
  129. public filings the minute they post, with the amounts as the ranges they are
  130. filed in. It has no access to anything that is not public.
  131. **The data comes from free public sources.** SEC EDGAR, the House Clerk, news
  132. RSS and Yahoo Finance's chart endpoint (unofficial, and it can change). Check
  133. anything that matters against your broker before you act on it.
  134. **Taxes.** `/trader-tax` does the arithmetic on lots and wash-sale windows. It
  135. is not tax advice.
  136. ## Files
  137. ```
  138. trader-copycat/ SKILL.md, edgar13f.py, filers.json, share_classes.json, targets.example.json
  139. trader-news/ SKILL.md, news.py
  140. trader-budget/ SKILL.md, size.py, config.example.json, targets.example.json
  141. trader-pelosi/ SKILL.md, ptr.py
  142. trader-analyst/ SKILL.md, facts.py, metrics.example.json
  143. trader-screener/ SKILL.md, screen.py, rules.example.json
  144. trader-risk/ SKILL.md, check.py
  145. trader-broker/ SKILL.md, ticket.py, claude_desktop_config.example.json
  146. trader-tax/ SKILL.md, lots.py, portfolio.example.json
  147. trader-alerts/ SKILL.md, alerts.py, alerts.example.json
  148. trader-rebalance/ SKILL.md, rebalance.py
  149. tests/ unittest suite + offline fixtures
  150. ```
  151. MIT. Made by [Jake Schincariol](https://opusjake.ai).

Ratings and comments

Sign in to rate this skill.

Sign in

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