trader-pelosi
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, o…
Install / Use
npx skills add Jakeschincariol/trader-skill --skill trader-pelosiInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of trader-pelosi
trader-pelosi scores 86/100 on our quality scale, 716th of 1,150 Content & Media skills we index.
Its SKILL.md is 7.1 KB long, well organised into 10 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
With 1,772 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 34 days ago, so trader-pelosi is actively maintained.
- 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.
trader-pelosi compared with similar skills
All 4 of these similar skills score higher than trader-pelosi; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| trader-pelosi (this skill)by Jakeschincariol | 86 | 1.8k | 34d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 56d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 56d ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install trader-pelosi?
- Run
npx skills add Jakeschincariol/trader-skill --skill trader-pelosi. The install tabs above show the steps for each supported agent. - Which AI agents does trader-pelosi 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 trader-pelosi safe to use?
- 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 trader-pelosi still maintained?
- The repository was last updated 34 days ago, so trader-pelosi is actively maintained.
Skill content
View source on GitHubname: 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):
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 intrader/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
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
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
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: the reel's 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: 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:
- The user opens
https://efdsearch.senate.gov/search/in their browser and accepts the agreement themselves. - They pick the report type "Periodic Transactions", type the senator's last name, set the date range and search.
- They open the report: electronic filings show a table of transactions, paper filings are scanned images.
- 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": trueintrader/config.json). - Nothing places an order except
/trader-broker, and only after/trader-riskpasses 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.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
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.
