Source profileQuality 92/100

HKUDS/Vibe-Trading/agent/src/skills/edgar-sec-filings/SKILL.md

edgar-sec-filings

SEC EDGAR filing analysis — 10-K, 10-Q, 8-K, proxy statements, insider Form 4. Extract key financials, risk factors, management discussion, and generate investment signals from US public company filings.

Source repository stars
31,714
Declared platforms
0
Static risk flags
1
Last source update
2026-08-25
Source checked
2026-08-26

Decision brief

What it does: where it fits

SEC EDGAR filing analysis — 10-K, 10-Q, 8-K, proxy statements, insider Form 4. Extract key financials, risk factors, management discussion, and generate investment signals from US public company filings.

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/HKUDS/Vibe-Trading --skill "agent/src/skills/edgar-sec-filings"
    Safe inspection promptEditorial

    Inspect the Agent Skill "edgar-sec-filings" from https://github.com/HKUDS/Vibe-Trading/blob/5cd08ee1bd5c28e856b20acae3d077ed9bd919ce/agent/src/skills/edgar-sec-filings/SKILL.md at commit 5cd08ee1bd5c28e856b20acae3d077ed9bd919ce. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      Filing Types and Investment Relevance

      Review the “Filing Types and Investment Relevance” section in the pinned source before continuing.

      Review and apply the “Filing Types and Investment Relevance” source section.
    2. 02

      EDGAR Data Access

      Review the “EDGAR Data Access” section in the pinned source before continuing.

      Review and apply the “EDGAR Data Access” source section.
    3. 03

      Direct EDGAR URLs

      Review the “Direct EDGAR URLs” section in the pinned source before continuing.

      Review and apply the “Direct EDGAR URLs” source section.
    4. 04

      Company filings search

      Review the “Company filings search” section in the pinned source before continuing.

      Review and apply the “Company filings search” source section.
    5. 05

      https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={ticker}&type={filingtype}

      Review the “https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={ticker}&type={filingtype}” section in the pinned source before continuing.

      Review and apply the “https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={ticker}&type={filingtype}” source section.

    Permission review

    Static risk signals and limitations

    Network access

    medium · line 27

    The documentation includes network, browsing, or remote request actions.

    # https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={ticker}&type={filing_type}

    Network access

    medium · line 30

    The documentation includes network, browsing, or remote request actions.

    url = "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=AAPL&type=10-K&dateb=&owner=include&count=10"

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score92/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars31,714SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    HKUDS/Vibe-Trading
    Skill path
    agent/src/skills/edgar-sec-filings/SKILL.md
    Commit
    5cd08ee1bd5c28e856b20acae3d077ed9bd919ce
    License
    MIT
    Collected
    2026-08-26
    Default branch
    main
    View the original SKILL.md

    SEC EDGAR Filing Analysis

    Overview

    Analyze US public company filings from SEC EDGAR to extract fundamental insights, risk signals, and investment-relevant information. Covers annual reports (10-K), quarterly reports (10-Q), current events (8-K), proxy statements (DEF 14A), and insider transactions (Form 4).

    This skill provides the analytical framework for interpreting SEC filings. Data retrieval uses read_url tool with EDGAR URLs or yfinance Ticker objects for structured financial data.

    Filing Types and Investment Relevance

    FilingFrequencyKey ContentSignal Value
    10-KAnnualFull-year financials, risk factors, MD&A, segment dataComprehensive fundamental view
    10-QQuarterlyQuarterly financials, interim MD&A, legal updatesTrend confirmation / inflection detection
    8-KEvent-drivenMaterial events: M&A, CEO change, restatement, guidanceCatalyst / risk trigger
    DEF 14AAnnual (proxy)Executive comp, board composition, shareholder proposalsGovernance quality signal
    Form 4Within 2 daysInsider buys / sellsInsider conviction signal
    13FQuarterlyInstitutional holdings >$100M AUMSmart money positioning
    SC 13D/GEvent-driven>5% ownership stake disclosureActivist / strategic investor signal

    EDGAR Data Access

    Direct EDGAR URLs

    # Company filings search
    # https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK={ticker}&type={filing_type}
    
    # Example: Apple 10-K filings
    url = "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=AAPL&type=10-K&dateb=&owner=include&count=10"
    
    # EDGAR full-text search (EFTS)
    # https://efts.sec.gov/LATEST/search-index?q={query}&dateRange=custom&startdt={start}&enddt={end}
    

    Via yfinance (structured data)

    import yfinance as yf
    ticker = yf.Ticker("AAPL")
    
    # Financial statements (derived from 10-K/10-Q)
    income = ticker.financials           # Annual income statement
    income_q = ticker.quarterly_financials  # Quarterly
    balance = ticker.balance_sheet       # Balance sheet
    cashflow = ticker.cashflow           # Cash flow statement
    
    # Insider transactions (derived from Form 4)
    insider = ticker.insider_transactions
    
    # Institutional holders (derived from 13F)
    institutions = ticker.institutional_holders
    major = ticker.major_holders
    

    10-K / 10-Q Analysis Framework

    I. Financial Statement Deep Dive

    Income Statement Focus:

    • Revenue growth rate: YoY and QoQ acceleration / deceleration
    • Gross margin trend: expanding (pricing power) vs compressing (cost pressure)
    • Operating leverage: SG&A as % of revenue declining = positive operating leverage
    • R&D intensity: R&D / revenue ratio vs peers
    • Non-recurring items: restructuring charges, impairments, one-time gains

    Balance Sheet Focus:

    • Cash & equivalents vs total debt: net cash / net debt position
    • Current ratio and quick ratio: liquidity health
    • Goodwill / intangibles as % of total assets: acquisition-driven growth risk
    • Inventory days (for manufacturers / retailers): rising = demand weakness signal
    • Accounts receivable days: rising = collection risk or channel stuffing

    Cash Flow Focus:

    • FCF = Operating CF - CapEx: true cash generation power
    • FCF conversion = FCF / Net Income: >80% = high earnings quality
    • CapEx intensity = CapEx / Revenue: rising = growth investment or maintenance burden
    • Stock-based compensation: add back to get true cash earnings
    • Buyback vs dividend: capital return strategy signal

    II. MD&A (Management Discussion & Analysis)

    The MD&A section is the most qualitative and forward-looking part of the filing.

    Key extraction targets:

    1. Revenue drivers: which segments / geographies are growing, which are declining
    2. Margin commentary: management explanation for margin changes
    3. Forward guidance language: "expect", "anticipate", "believe" — tone shift detection
    4. Risk factor changes: compare risk factors vs prior filing; NEW risks added = material change
    5. Liquidity and capital resources: debt maturity schedule, credit facility availability

    Tone analysis signals:

    # Simplified tone scoring
    positive_words = ["growth", "improvement", "strong", "exceeded", "momentum", "opportunity"]
    negative_words = ["challenging", "decline", "uncertainty", "headwind", "pressure", "risk"]
    cautious_words = ["moderate", "cautious", "prudent", "measured", "selective"]
    
    # Count frequency change vs prior filing
    # Rising negative word count = deteriorating outlook
    # Rising cautious words = management hedging
    

    III. Risk Factor Analysis

    Risk factor change detection (10-K vs prior 10-K):

    Change TypeSignalAction
    New risk factor addedMaterial new risk identifiedDeep dive on the specific risk
    Risk factor removedRisk resolved or deemed immaterialPositive signal if genuine resolution
    Language intensifiedRisk escalatingReview exposure and hedging
    Order changed (moved higher)Risk priority elevatedAssess potential impact magnitude

    Common risk categories for US equities:

    • Regulatory / legal risk (antitrust, FDA, patent expiry)
    • Customer concentration (>10% revenue from single customer must be disclosed)
    • Geographic concentration (China exposure, emerging market risk)
    • Technology disruption risk
    • Cybersecurity risk (new SEC mandate: material cybersecurity incidents must be disclosed in 8-K)
    • Climate / ESG risk (increasingly required)

    8-K Event Analysis

    Material Event Classification

    Event Type8-K ItemTypical Price ImpactTime Sensitivity
    Earnings pre-release2.02HighImmediate
    M&A announcement1.01Very highImmediate
    CEO / CFO departure5.02Medium-highSame day
    Restatement4.02Very high (negative)Immediate
    Guidance revision7.01/8.01HighSame day
    Credit agreement change1.01Low-mediumMonitor
    Share repurchase program8.01Low positiveBackground signal
    Dividend change8.01MediumSame day

    8-K Signal Rules

    # High-priority 8-K events
    if item == "4.02":  # Restatement
        signal = "strong_negative"  # Restatements destroy trust
        action = "review_all_prior_financials"
    elif item == "2.02" and surprise_direction == "negative":
        signal = "negative"  # Earnings pre-announcement miss
    elif item == "5.02" and role in ["CEO", "CFO"]:
        signal = "uncertainty"  # C-suite departure = governance risk
    elif item == "1.01" and event_type == "acquisition":
        signal = "evaluate"  # M&A: acquirer usually -2 to -5%, target +20-40%
    

    Insider Transaction Analysis (Form 4)

    Signal Framework

    PatternSignalConfidence
    Cluster buying: 3+ insiders buying within 30 daysStrong bullishHigh
    CEO/CFO large open-market purchase (>$500K)BullishHigh
    Insider buying after price decline >20%Contrarian bullishMedium-high
    Cluster selling at all-time highsNeutral to mildly bearishLow (may be pre-planned)
    CFO selling >50% of holdingsBearishMedium
    10b5-1 plan salesNeutralLow (pre-programmed)

    Key distinctions:

    • Open-market purchases (most informative): insider spending own money
    • 10b5-1 plan sales (least informative): pre-programmed, regulatory safe harbor
    • Option exercises + immediate sale: often tax-driven, low signal value
    • Gift transactions: ignore for signal purposes
    # Insider signal scoring
    def score_insider_activity(transactions, lookback_days=90):
        buys = [t for t in transactions if t.type == "Purchase" and t.days_ago <= lookback_days]
        sells = [t for t in transactions if t.type == "Sale" and t.days_ago <= lookback_days]
    
        buy_value = sum(t.value for t in buys)
        sell_value = sum(t.value for t in sells)
    
        # Filter out 10b5-1 plan sales
        organic_sells = [s for s in sells if not s.is_10b5_1]
    
        if len(buys) >= 3 and buy_value > 1_000_000:
            return "strong_bullish"
        elif buy_value > sell_value * 2:
            return "bullish"
        elif len(organic_sells) >= 3 and sell_value > 5_000_000:
            return "bearish_watch"
        else:
            return "neutral"
    

    13F Institutional Holdings Analysis

    Smart Money Tracking

    Key metrics:

    • Number of institutional holders: rising = broadening ownership base
    • Top 10 holder concentration: >50% = concentrated, vulnerable to single-fund redemption
    • New positions initiated this quarter: smart money entering
    • Positions closed this quarter: smart money exiting
    • Activist stakes (SC 13D): potential for corporate action catalyst

    Institutional quality tiers:

    1. Tier 1 — Conviction signals: Berkshire, Baupost, Greenlight, Pershing Square, Tiger Global
    2. Tier 2 — Trend signals: BlackRock, Vanguard, Fidelity (flow-driven, less stock-picking signal)
    3. Tier 3 — Quantitative: Renaissance, Two Sigma, Citadel (high turnover, less directional signal)
    # 13F change detection
    def analyze_13f_changes(current_holders, prior_holders):
        new_positions = current_holders - prior_holders  # New entries
        closed_positions = prior_holders - current_holders  # Exits
    
        # Flag: multiple Tier 1 funds initiating
        tier1_new = [h for h in new_positions if h.tier == 1]
        if len(tier1_new) >= 2:
            signal = "strong_smart_money_accumulation"
    
        return signal
    

    Composite Filing Signal

    Scoring Template

    filing_score = {
        "financial_health": 0,       # -2 to +2: based on 10-K/10-Q financials
        "management_tone": 0,        # -2 to +2: MD&A sentiment shift
        "risk_factor_change": 0,     # -2 to +2: new risks vs resolved risks
        "insider_activity": 0,       # -2 to +2: net insider buying/selling
        "institutional_flow": 0,     # -2 to +2: 13F position changes
        "event_catalyst": 0,         # -2 to +2: recent 8-K impact
    }
    # Total range: -12 to +12
    # > +6: strong fundamental bullish
    # +2 to +6: mild bullish
    # -2 to +2: neutral
    # < -2: fundamental caution
    

    Output Format

    ## SEC Filing Analysis — [Ticker]
    
    ### Filing Summary
    - **Latest 10-K/10-Q**: [date], [period]
    - **Recent 8-K events**: [list material events]
    - **Insider activity (90d)**: [net buy/sell summary]
    
    ### Financial Health
    - Revenue trend: [accelerating / stable / decelerating]
    - Margin trajectory: [expanding / stable / compressing]
    - FCF conversion: [strong / adequate / weak]
    - Balance sheet: [net cash / moderate leverage / high leverage]
    
    ### MD&A Tone Shift
    - vs prior filing: [more optimistic / unchanged / more cautious]
    - Key language changes: [specific quotes or paraphrases]
    
    ### Risk Factor Changes
    - New risks: [list any new risk factors added]
    - Intensified risks: [list risks with stronger language]
    - Resolved risks: [list removed risk factors]
    
    ### Insider & Institutional Signals
    - Insider net activity: [cluster buy / neutral / cluster sell]
    - Institutional positioning: [accumulation / stable / distribution]
    
    ### Composite Signal
    | Dimension | Score (-2~+2) | Basis |
    |-----------|---------------|-------|
    | Financial health | +1 | Revenue accelerating, margins stable |
    | Management tone | -1 | More cautious language in MD&A |
    | ... | ... | ... |
    
    ### Investment Implication
    - Direction: [bullish / bearish / neutral]
    - Confidence: [high / medium / low]
    - Key monitoring: [next earnings date, upcoming 8-K triggers]
    

    Notes

    • EDGAR filings are public and free; no API key required (rate limit: 10 requests/second with User-Agent header)
    • 10-K/10-Q data is backward-looking; combine with forward guidance and analyst estimates for complete view
    • Insider transaction data has a 2-business-day reporting lag; real-time insider data requires paid services
    • 13F data is reported with a 45-day lag after quarter-end; positions may have already changed
    • This framework is for research purposes only and does not constitute investment advice

    Frequently asked questions

    What to verify before installation and use

    What does the edgar-sec-filings source document cover?

    SEC EDGAR filing analysis — 10-K, 10-Q, 8-K, proxy statements, insider Form 4. Extract key financials, risk factors, management discussion, and generate investment signals from US public company filings.

    How do I install edgar-sec-filings?

    The source record exposes this install command: npx skills add https://github.com/HKUDS/Vibe-Trading --skill "agent/src/skills/edgar-sec-filings". Inspect the command and pinned source before running it.

    Which permission-related actions were detected?

    Static rules flagged network in the source; the page lists the matching lines and excerpts.

    Alternatives

    Compare before choosing

    Computed 10045,643

    coreyhaines31/marketingskills

    ab-testing

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

    Computed 10045,643

    coreyhaines31/marketingskills

    churn-prevention

    When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

    Computed 10024,975

    alirezarezvani/claude-skills

    app-store-optimization

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist

    Computed 10015,246

    wanshuiyin/Auto-claude-code-research-in-sleep

    citation-audit

    Use it for operations and research tasks; the detail page covers purpose, installation, and practical steps.