Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/dgunning/edgartools/corenpx skills add dgunning/edgartools --skill coregit clone --depth 1 https://github.com/dgunning/edgartoolsWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00012 | $0.00354 |
| Opus 5 | $0.00006 | $0.00177 |
| Sonnet 5 | $0.00002 | $0.00071 |
| Haiku 4.5 | $0.00001 | $0.00035 |
Grade A, and why
EdgarTools scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- EdgarTools — 100% identical, 0 lines differ
What it actually says
EdgarTools
Analyze SEC filings and financial statements.
Skills
| Skill | Purpose |
|---|---|
| core (this directory) | Company lookup, filings, search |
| financials/ | Financial statements and metrics |
| reports/ | 10-K/10-Q/8-K section extraction |
| holdings/ | 13F institutional holdings |
| ownership/ | Form 3/4/5 insider transactions |
| xbrl/ | Low-level XBRL facts and concepts |
| forms.yaml | SEC form type mappings |
Each skill directory has skill.yaml (patterns and examples) and sharp-edges.yaml (common mistakes to avoid).
Quick Setup
from edgar import set_identity
set_identity("Your Name [email protected]") # Required
API Discovery
Every object has .docs for API reference:
company.docs # Full API guide
company.docs.search("filings") # Search for specific topic
filing.docs.search("xbrl") # How to access XBRL
Common Entry Points
from edgar import Company, get_filings, find
company = Company("AAPL") # By ticker
filing = find("0000320193-25-000079") # By accession
filings = get_filings(form="10-K", year=2024) # Discovery
What ships with it
6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 50 lines · 12 tokens per session scan A 65ff350a67cb
EdgarTools is a skill published in the GitHub repository dgunning/edgartools (2,644 stars, last pushed today), licensed MIT. It adds 12 tokens to every session and 354 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
edgrapi-filings
Company profiles and recent SEC filings from EDGAR via Edgrapi.com. Resolve a US-listed ticker to its CIK, industry, fiscal-year end, and exchange, and list its recent 10-K / 10-Q / 8-K filings with document links.
financial-modeling
Build integrated financial models with 3-statement projections. Create income statement, balance sheet, and cash flow models with proper linkages.
financial-filings-research
Use for questions about a public company's regulatory filings or financials — revenue, EBITDA, net income, debt, cash flow, 10-K/20-F/annual reports, insider transactions, peer or industry screening, or resolving a company by name, ticker, ISIN or LEI via the FinancialReports MCP connector. Carries the workflows plus…
annual_report_parser
Parse PDF annual reports from global exchanges. Extracts TOC, chapters, financial highlights, and key narrative sections.
financial-statement-generation
Generates the three core financial statements — P&L (income statement), balance sheet, and cash flow statement — with proper formatting, classifications, and period-over-period comparisons. Use when the user mentions financial statement generation, producing a P&L, creating a balance sheet, formatting a cash flow…
xvary-stock-research
Use when building thesis-driven equity analysis in Claude Code from public SEC EDGAR data and market snapshots — workflows /analyze, /score, /compare with bundled Python tools.