Skip to main content
skill CX Codex

trader-pelosi — Claude Code skill: what it does, how to install

trader-pelosi is a Claude Code skill that monitors stock trades disclosed by members of US Congress. It checks House Clerk PTR index files and extracts transactions from filed PDFs.

MIT ★ 9,067 updated 2026-10-20

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill
Open on GitHub

What trader-pelosi does

The skill tracks Periodic Transaction Reports (PTR) filed by US House representatives under the STOCK Act. A Python script named ptr.py downloads the yearly index from the House Clerk website, compares DocIDs against trader/state/pelosi.json, and records unseen entries. If trader/portfolio.json exists in the repository, it flags transactions that match user holdings.

Document parsing uses standard Python libraries, with an optional pdftotext utility from the poppler package for local text extraction. The tool extracts owner labels, tickers, value ranges, trade dates, disclosure delays, and options contracts with strikes and expiration dates. Members disclose trades 30 to 45 days after execution, meaning filings reflect historical activity.

Running the script requires Python 3. Filings from the US Senate are not scraped automatically because the Senate disclosures site requires accepting terms manually in a browser.

What it helps with

  • track periodic stock disclosures filed by US Congress members
  • detect newly published PTR filings from the House Clerk index
  • parse financial PDF filings into structured transaction rows
  • compare disclosed politician trades against held assets

Example prompts for the agent

  • Check new stock filings for Nancy Pelosi with trader-pelosi
  • List recent PTR disclosures for Josh Gottheimer
  • Fetch and parse House PTR DocID 20035143

How to install trader-pelosi

1Plugin marketplace

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

This installs the whole day-trader-skill plugin with all its skills

2Skills CLI (Vercel)

npx skills add Jakeschincariol/day-trader-skill --skill trader-pelosi -a claude-code

3Manually: put the files in place

~/.claude/skills/trader-pelosi/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/trader-pelosi/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about trader-pelosi

How to install trader-pelosi in Claude Code?

Run /plugin marketplace add Jakeschincariol/day-trader-skill, then run /plugin install day-trader-skill@day-trader-skill.

What does trader-pelosi do?

It monitors House Clerk PTR filing indexes, alerts on new congressional disclosures, and parses downloaded PDF reports into tables with dates, tickers, and price ranges.

What is required to run trader-pelosi?

It requires Python 3 with the standard library. The pdftotext binary from poppler is optional for local text parsing, while Senate lookups require manual browser access.

Source text

SKILL.md · MIT
---
name: trader-pelosi
description: >-
  The Pelosi Tracker. Watches the stock trades members of Congress must
  disclose under the STOCK Act: reads the House Clerk's public Periodic
  Transaction Reports (PTRs) as soon as they are posted, alerts once per new
  filing, and turns each PDF into clean rows (who, owner, stock, ticker,
  buy or sell, options strike and expiry, trade date, amount range, how many
  days it took to disclose). Flags trades in stocks you hold. Senate reports
  are covered by a documented manual route. Use when the user says "what is
  Pelosi buying", "track Nancy Pelosi", "Congress trades", "politician stock
  trades", "did any congressman buy X", "alert me when Pelosi files", or
  "run the Pelosi skill".
argument-hint: "[member name] [--read]"
---

# trader-pelosi

Members of Congress have to report their trades, their spouse's and their
dependent children's. The House Clerk posts every report as a PDF and lists
them all in one index file per year. This skill reads that index, notices the
moment a new report appears, and reads the report for you.

It is fast. It is not early. A PTR is due within 30 days of the member
learning of the trade and never more than 45 days after it, so by the time
anyone can read it the trade is days or weeks old. There is no inside
information here: only public filings, read quickly. Say that every time.

Tool in this folder (standard library Python; `pdftotext` from poppler is
optional, to read the PDFs locally):

```bash
python3 "${CLAUDE_SKILL_DIR}/ptr.py" --help
```

## What it reads and writes

- Reads `https://disclosures-clerk.house.gov/public_disc/financial-pdfs/<YEAR>FD.zip`
  (one `<Member>` per filing: name, district, FilingType, FilingDate, DocID)
  and each PTR at `.../public_disc/ptr-pdfs/<YEAR>/<DocID>.pdf`.
- Writes `trader/state/pelosi.json` (the DocIDs already shown, so each PTR
  alerts once) and keeps downloaded PDFs in `trader/state/ptr-pdfs/`.
- Reads `trader/portfolio.json` (if it exists) to flag trades in what you hold.

## The rules

- **Quote the filing, not a tracker.** Every row comes from the PTR PDF on the
  Clerk's site, with its DocID and link. Third-party trackers are fine for
  browsing but can be off (Capitol Trades showed Pelosi's trade dates one day
  earlier than her PTRs). The PTR wins.
- **Amounts are ranges.** "$1,000,001 - $5,000,000", never "$3 million".
- **Owner matters.** SP is the spouse, JT joint, DC a dependent child, blank
  the member. Pelosi's 2026 trades are all SP: Paul Pelosi.
- **Say the delay.** Each row shows how many days passed between the trade
  and the filing; over 45 is flagged as late.
- **Options are options.** A call bought with a strike and an expiry is not
  a share purchase. The tool reads contracts, strike and expiry from the
  description and marks exercises.

## Step 1: what has been filed

```bash
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member pelosi
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --since 2026-10-01        # every member
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member "Josh Gottheimer" --year 2025
```

`--member` takes a last name, "First Last" or "Last, First", and repeats.
`--type ''` lists every filing type (annual reports are type O).

## Step 2: watch for new ones

```bash
python3 "${CLAUDE_SKILL_DIR}/ptr.py" new --member pelosi --read
```

Shows only PTRs not seen at the last check (the first run shows the last 45
days), downloads and reads them with `--read`, and records them in the state
file. Exit code 1 means nothing new. In January it also checks last year's
index. The Clerk rebuilds the index file about once a day (the copy read on
2026-10-13 was stamped 09:00 that morning), so checking every hour on weekdays
is plenty: run it with `/loop 1h` or a scheduled task.

## Step 3: read a report

```bash
python3 "${CLAUDE_SKILL_DIR}/ptr.py" fetch 20035143
python3 "${CLAUDE_SKILL_DIR}/ptr.py" parse ptr.txt --filed 2026-08-21 --json
```

`fetch` saves the PDF and, if `pdftotext` is installed, prints the rows. If it
is not installed, open the saved PDF and read it directly: you can read PDFs.
`parse` turns `pdftotext -layout` text into rows. Check the row count against
the PDF when a report runs over several pages.

## Example: a real alert

```
NEW Periodic Transaction Report: Hon. Nancy Pelosi (CA11) filed 2026-08-21, doc 20035143
  - spouse purchase, Bloom Energy Corporation Class A Common Stock (BE): 100 call
    options, $100 strike, expires 2027-06-17, $1,000,001 - $5,000,000, traded
    2026-07-24, disclosed 28 days later
```

The same PTR also shows 10,000 and 5,000 BE shares, a second block of 100 BE
calls on 07/28, Intel shares and 50 Intel calls ($50 strike, 6/17/27), and a
private real estate LLC with no ticker. Her other 2026 PTRs: 20033725
(01/23), 20034836 (06/23, Intel and Uber calls) and 20035553 (10/02, a real
estate LLC). Then: "This is a public disclosure filed 28 days after the trade.
It says what Paul Pelosi bought in July, not what anyone will buy next."

If the user wants to act on it, it goes the long way: a disclosure is weeks
old, so it is a reason to look at a chart, not a setup. `/trader-scanner`
and `/trader-entry` decide if there is a trade today; then shares only (the
config has `allow_options: false`), sized by `/trader-budget`, checked by
`/trader-risk`, placed by `/trader-broker` only after their yes.

## The Senate: the manual route

Senate reports live at `https://efdsearch.senate.gov`. Before searching, the
site asks you to tick a box agreeing to the legal limits on how the reports
may be used. That is an agreement for the person to accept, so this skill
does not click it or automate it. The route:

1. The user opens `https://efdsearch.senate.gov/search/` in their browser and
   accepts the agreement themselves.
2. They pick the report type "Periodic Transactions", type the senator's last
   name, set the date range and search.
3. They open the report: electronic filings show a table of transactions,
   paper filings are scanned images.
4. They paste the table (or a screenshot, or the saved page) into the chat,
   and you write it up in the same shape as the House rows, with the report
   link, and the same 45-day caveat.

## What it never does

- Never says or implies a member has inside information, or that copying a
  politician beats the market. No return claims.
- Never presents a range as an exact dollar figure or a tracker's date as the
  trade date.
- Never places an order, and never copies options trades.
- Never automates the Senate agreement or any login.

## Safety

- Education and tooling, not financial advice. Nothing in this pack is a
  recommendation to buy or sell anything.
- Paper trading by default (`"paper": true` in `trader/config.json`).
- Nothing places an order except `/trader-broker`, and only after
  `/trader-risk` passes AND the user types an explicit yes for that order in
  the chat, AND the brokerage tool is set to "Needs approval" in Claude
  (Customize > Connectors > tool permissions) so Claude's own "Allow once /
  Deny" card appears too. Never "Always allow" an order tool.
- No options, margin, shorting or leverage unless the config allows it and
  the user confirms.
- Congressional trades are PUBLIC disclosures filed up to 45 days after the
  trade (STOCK Act). This skill reads them fast; it has no inside
  information, and it says so.

© Jake Schincariol · MIT · Jakeschincariol/day-trader-skill

Similar skills

All skills for Finance and business →

From the same set12

The whole set →
day-trader-skill The day-trader-skill plugin for Claude Code runs eleven day trading tools including a chart scanner, news monitor, entry timer, and trade outcome simulator. ★ 9,067repo stars trader-news trader-news is a Claude Code skill that tracks stock headlines, 8-K filings, and price moves. It runs for ticker questions, morning briefs, and checks after /trader-scanner. CX Codex +1 ★ 9,067repo stars trader-analyst trader-analyst is a Claude Code skill that reads company filings directly from SEC EDGAR. It compares revenue, margins, and EPS year over year before earnings trades. CX Codex +1 ★ 9,067repo stars trader-exit trader-exit is a Claude Code skill that sets stops and profit targets before entering long day trades. Triggers automatically after trader-entry or on prompts like "where's my stop". CX Codex +1 ★ 9,067repo stars trader-entry trader-entry is a Claude Code skill that watches market bars and names an entry after a close above a level. It starts from requests to watch a ticker or check a breakout. CX Codex +1 ★ 9,067repo stars trader-alerts trader-alerts is a Claude Code skill that tracks stock prices, stop levels, and NYSE session times. Triggers when checking quotes, watching stops, or right after generating a trade plan. CX Codex +1 ★ 9,067repo stars trader-budget trader-budget is a Claude Code skill that sizes positions from a budget and per-trade loss limit. It runs on share-count requests or after trader-exit writes a plan. CX Codex +1 ★ 9,067repo stars trader-risk trader-risk is a Claude Code skill that inspects proposed orders against risk limits before passing them to the broker. It blocks entries lacking stops or exceeding daily loss caps. CX Codex +1 ★ 9,067repo stars

Project sponsors

Companies that keep this analytics open