sec-mda-analysis — Claude Code skill: what it does, how to install
sec-mda-analysis parses MD&A sections from SEC 10-K and 10-Q filings through the Octagon MCP server to track corporate strategy and risks.
MIT 258 installs ★ 132 updated 2026-06-05
npx skills add OctagonAI/skills --skill sec-mda-analysis -a claude-codeWhat sec-mda-analysis does
The skill equips your AI assistant with workflows to examine the Management Discussion and Analysis section inside SEC public filings. It targets equity tickers such as AAPL or GOOGL across annual 10-K reports or quarterly 10-Q forms. The workflow surfaces details on corporate initiatives, operating cost shifts, macroeconomic headwinds, and future performance disclaimers.
Execution relies on calling the octagon-agent tool via the octagon-mcp connection. It outlines explicit patterns to track sequential or year-over-year adjustments, assess shifts in executive tone, and break down operating performance across business segments.
Without an active octagon-mcp integration configured in your agent workspace, query calls will fail.
What it helps with
- extract corporate performance commentary from quarterly 10-Q filings
- compare executive forward-looking statements across sequential periods
- evaluate shifts in management tone regarding industry headwinds
- gather capital allocation and liquidity data from annual 10-K filings
Example prompts for the agent
- Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report
- Extract the financial performance discussion from GOOGL's latest MD&A
- Compare the MD&A commentary between TSLA's Q4 2025 and Q4 2024 10-Q filings
How to install sec-mda-analysis
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill sec-mda-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/sec-mda-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sec-mda-analysis/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill sec-mda-analysis -a codex2Manually: put the files in place
.agents/skills/sec-mda-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill sec-mda-analysis -a cursor2Manually: put the files in place
.cursor/skills/sec-mda-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/sec-mda-analysis2Manually: put the files in place
.github/skills/sec-mda-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill sec-mda-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/sec-mda-analysisManually: put the files in place
.devin/skills/sec-mda-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill sec-mda-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sec-mda-analysis
How to install sec-mda-analysis in Claude Code?
Run npx skills add OctagonAI/skills --skill sec-mda-analysis -a claude-code in your terminal.
What does sec-mda-analysis do?
It provides structured prompts and workflows to query SEC MD&A disclosures via Octagon MCP, extracting operational drivers, strategic initiatives, and risks.
What prerequisite setup does sec-mda-analysis require?
You must have the octagon-mcp server configured inside your AI agent environment to supply the octagon-agent tool.
Source text
SKILL.md · MIT
---
name: sec-mda-analysis
description: Analyze Management Discussion and Analysis (MD&A) sections from SEC filings using Octagon MCP. Use when extracting strategic initiatives, financial performance commentary, macroeconomic challenges, and forward-looking statements from 10-K and 10-Q filings.
---
# SEC MD&A Analysis
Analyze the Management Discussion and Analysis (MD&A) section from SEC filings for public companies using the Octagon MCP server.
## Prerequisites
Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.
## Workflow
### 1. Identify Analysis Parameters
Determine the following before querying:
- **Ticker**: Stock symbol (e.g., AAPL, MSFT, GOOGL)
- **Filing Type** (optional): 10-K (annual) or 10-Q (quarterly)
- **Focus Areas** (optional): Strategic initiatives, financial performance, risks
### 2. Execute Query via Octagon MCP
Use the `octagon-agent` tool with a natural language prompt:
```
Analyze the Management Discussion and Analysis section from <TICKER>'s latest quarterly report.
```
**MCP Call Format:**
```json
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report."
}
}
```
### 3. Expected Output
The agent returns structured MD&A analysis including:
**Strategic Initiatives:**
- Launched new products: MacBook Pro, iPad Pro, Apple Vision Pro
- Increased R&D spending to drive innovation
- Continued capital return program via stock repurchases and dividends
**Macroeconomic Challenges:**
- Addressed inflation, interest rates, and currency fluctuations
- Mitigation strategies: Derivative instruments for hedging
**Financial Performance:**
- Revenue drivers: Strong iPhone and services sales
- Cost management: Improved gross margins, increased R&D expenses
**Risks & Forward-Looking Statements:**
- Key risks: Macroeconomic conditions and trade measures
- Caution on future performance: Actual results may vary
**Data Sources**: octagon-sec-agent
### 4. Interpret Results
See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding MD&A structure
- Evaluating management commentary
- Identifying key performance drivers
- Assessing forward-looking statements
## Example Queries
**Standard MD&A Analysis:**
```
Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report.
```
**Annual MD&A Review:**
```
Analyze the MD&A section from MSFT's latest 10-K filing and summarize key strategic themes.
```
**Performance Commentary:**
```
Extract the financial performance discussion from GOOGL's latest MD&A.
```
**Strategic Focus:**
```
What strategic initiatives does AMZN highlight in their latest MD&A section?
```
**Comparative Analysis:**
```
Compare the MD&A commentary between TSLA's Q4 2025 and Q4 2024 10-Q filings.
```
**Segment Analysis:**
```
Analyze the segment performance discussion in META's latest MD&A.
```
## MD&A Section Components
### Results of Operations
| Component | Description |
|-----------|-------------|
| Revenue Analysis | Segment breakdown, growth drivers, geographic mix |
| Cost of Revenue | Gross margin trends, cost structure changes |
| Operating Expenses | R&D, SG&A, marketing spend trends |
| Operating Income | Margin analysis, operational leverage |
| Other Income/Expense | Interest, investments, one-time items |
| Tax Discussion | Effective rate, tax planning, credits |
### Liquidity & Capital Resources
| Component | Description |
|-----------|-------------|
| Cash Position | Cash and equivalents, investments |
| Cash Flow | Operating, investing, financing activities |
| Debt Structure | Borrowings, maturities, covenants |
| Capital Allocation | CapEx, M&A, shareholder returns |
| Working Capital | Receivables, inventory, payables |
### Critical Accounting Policies
| Component | Description |
|-----------|-------------|
| Revenue Recognition | Policies, judgments, timing |
| Estimates | Goodwill, impairments, reserves |
| Contingencies | Legal, tax, environmental |
| Fair Value | Measurement methodologies |
### Forward-Looking Statements
| Component | Description |
|-----------|-------------|
| Guidance | Revenue, earnings, margin outlook |
| Strategy | Product plans, market expansion |
| Risks | Key uncertainties, market factors |
| Safe Harbor | Legal disclaimers |
## Key Analysis Areas
### Management Tone Analysis
| Tone | Indicators |
|------|------------|
| Optimistic | "Strong performance," "exceeded expectations," "momentum" |
| Cautious | "Challenges," "headwinds," "uncertainty" |
| Defensive | "Despite," "although," "notwithstanding" |
| Confident | "Expect," "anticipate," "believe" |
### Performance Drivers
**Positive Signals:**
- Volume growth highlighted
- Market share gains
- New product success
- Margin expansion
- Operational efficiency
**Warning Signs:**
- Revenue concentration
- Margin pressure
- Increased competition
- Regulatory concerns
- One-time benefits
### Strategic Themes
| Theme | What to Look For |
|-------|------------------|
| Growth | New markets, products, acquisitions |
| Efficiency | Cost cutting, automation, restructuring |
| Innovation | R&D investment, patents, technology |
| Capital Allocation | Buybacks, dividends, CapEx |
| Risk Management | Hedging, diversification, compliance |
## Comparing MD&A Over Time
### Key Comparisons
| Period | Focus |
|--------|-------|
| Sequential (Q/Q) | Short-term trends, seasonal patterns |
| Year-over-Year (Y/Y) | Annual growth, cycle position |
| Multi-Year | Strategic evolution, long-term trends |
### Change Analysis
Track changes in:
1. **Narrative emphasis** - Topics receiving more/less attention
2. **Quantitative guidance** - Specific numbers vs. ranges
3. **Risk discussion** - New concerns vs. resolved issues
4. **Strategic priorities** - Shifting focus areas
5. **Tone** - Confidence level changes
## Analysis Tips
1. **Read between the lines**: What management doesn't discuss can be as important as what they do.
2. **Compare to prior periods**: Look for changes in emphasis, tone, and specificity.
3. **Cross-reference financials**: Verify MD&A claims against actual numbers.
4. **Note non-GAAP metrics**: Management often emphasizes adjusted figures.
5. **Track guidance accuracy**: Compare past guidance to actual results.
6. **Identify recurring themes**: Consistent messaging vs. shifting narratives.
## Use Cases
- **Earnings analysis**: Understand quarterly/annual performance drivers
- **Investment research**: Assess management quality and strategy
- **Competitive intelligence**: Compare management commentary across peers
- **Risk assessment**: Identify emerging concerns and challenges
- **Valuation support**: Gather context for financial modeling
© OctagonAI · MIT · OctagonAI/skills