Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    TopxAI Equity Research

    1

    Filings-first equity research for AI agents: sourced numbers, a bull/bear debate, adversarial audits and a ledger that settles every call.

    Free

    1 useSecurity scanned
    TopxAI Equity Research

    TopxAI Equity Research

    Example session with this skill installed

    Pull the last eight quarters for NVDA from SEC filings.

    • Read your context and instructions
    • Compiled the topxai equity research

    Summary

    Ran scripts/sec.py facts NVDA on 2026-10-13. The raw SEC companyfacts response (4.5 MB) stayed in the local cache; the agent received 3.3 KB of JSON. Evidence grade [A]. Source: https://data.sec.gov/api/xbrl/companyfacts/CIK0001045810.json

    Last eight quarters (USD bn, calendar quarters)

    QuarterRevenueGross profitOperating incomeNet incomeOperating cash flowCapex
    CY2024Q335.126.221.919.317.60.8
    CY2024Q439.328.724.022.116.61.1
    CY2025Q144.126.721.618.827.41.2
    CY2025Q246.733.928.426.415.41.9
    CY2025Q357.041.836.031.923.81.6
    CY2025Q468.151.144.343.036.21.3
    CY2026Q181.661.253.558.350.31.8
    CY2026Q296.272.163.759.724.12.7

    Quarters come from the XBRL facts: discrete quarters where the filing reports them, otherwise year-to-date differences. For example, CY2026Q2 operating cash flow = 74.4 (six months to 2026-07-26) − 50.3 (first quarter) = 24.1.

    Latest balance-sheet items

    From the 10-Q for the period ended 2026-07-26, filed 2026-08-26 (USD bn):

    • Cash and cash equivalents: 22.4
    • Long-term debt: 33.4
    • Remaining performance obligations: 3.2
    • Shares outstanding: 24.1bn (as of 2026-08-21)

    Next steps

    • Cross-check these numbers against the research-lane notes and list any conflicts in notes-crosscheck.md.
    • Run scripts/sec.py filings NVDA for recent 8-K items before fixing the report's basis dates.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    TopxAI Equity Research turns an AI agent into a research desk. It takes a company, a value chain or a macro question from kickoff to a finished report, then tracks every call the report made and settles each one when it comes due. It is the method behind the research published at topxea.com, released free under Apache-2.0.

    What it enforces

    • Every key number traces to a source with a link. If it cannot be found, the report says "not verified".
    • Evidence grades run from [A] primary filings to [D] unconfirmed reports. No [D] input may hold up a core conclusion.
    • One basis date in three layers: the last closed session, the financial period end and filing date, and a filing cutoff.
    • Every core conclusion states what would prove it wrong.
    • Ratings are settleable: 12 months, against a named benchmark, from the publication-date close.

    What's inside

    • A ten-step pipeline (kickoff, research lanes, bull/bear debate, writing, judgment, two audit rounds, publish, watch, settle, update). Each step names its output files and an exit gate.
    • Method files: a cause / process / outcome framework, nine-step flows for single-stock, industry and macro reports, a quality bar, a catalogue of accounting traps, and an indicator library with primary sources (SEC EDGAR, FRED, BLS, Census, FINRA).
    • Three Python tools that use only the standard library: sec.py (SEC XBRL facts and filings; the raw JSON stays in a local cache), ledger.py (an append-only call ledger with settlement lessons) and desk.py (the coverage watch).
    • Templates for the kickoff note, the source cross-check, audit decisions, final checks and disclosures.
    • The Claude Code plugin on GitHub adds five role agents: collector, bull, bear, auditor and translator.

    Limits

    The skill supplies the method, not market data; price triggers read a CSV you provide. The tools contact only sec.gov and data.sec.gov, with no telemetry and no account. A full company deep dive can use millions of tokens. Output is general research information, not personalised investment advice, and ratings are research judgments, not orders.

    Source, plugin and docs: https://github.com/UnbelievableT/topxai-equity-research

    No market data: price triggers in the coverage watch read a CSV you provide. The SEC tool needs SEC_USER_AGENT set to a name and email. A full company deep dive can use millions of tokens. Report quality is bounded by the underlying model; the rules stop invented numbers and unfalsifiable conclusions, not a wrong read of an industry. Events after a report's basis date are not reflected. Output is general research information, not personalised investment advice.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    • Free with an Agensi account

    Requires

    Sec

    Permissions

    Terminal / Shell
    Environment Variables
    Read Files
    Write Files
    Network Access

    Allowed Hosts

    data.sec.gov
    www.sec.gov

    Shell runs the bundled Python scripts (sec.py, ledger.py, desk.py). Read/write files: notes, reports and the ledger are written under research/ in your project. Network: the scripts contact only www.sec.gov and data.sec.gov; the agent may also open primary sources such as FRED or FINRA while researching. Environment variable: SEC_USER_AGENT (your name and email, required by the SEC's fair-access policy).

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    A plain prompt gets fluent text with numbers of unknown origin. This skill makes the agent pull figures from primary filings (sec.py reads SEC XBRL data), grade every piece of evidence, hold a bull/bear debate before setting a rating, run two adversarial audit rounds, and register each call in a ledger with a stated falsifier and due date.

    The SKILL.md workflow, method files (framework, judgment, equity / industry / macro flows, indicators, pitfalls, quality bar, desk), pipeline step files, three standard-library Python tools (sec.py, ledger.py, desk.py), templates and a disclosure template. The Claude Code plugin on GitHub also adds five role agents.

    Any agent that reads the SKILL.md standard, including Claude Code, Codex CLI, Cursor, Gemini CLI and OpenClaw. The tools need Python 3.9+ and a shell. Agents without subagents play the five roles one after another.

    No keys. The SEC asks every client to identify itself, so set SEC_USER_AGENT to your name and email. Prices for the coverage watch come from a CSV you supply.

    ledger.py keeps an append-only ledger. Each call has a falsifier, a horizon and a benchmark; desk.py lists calls that are coming due or whose falsifier was hit by a new filing. You settle each one with evidence and a one-sentence lesson. The hit rate counts hits divided by hits plus misses; open calls are excluded.

    New in Research & Analysis