# yennanliu/investskill architecture

> Architecture diagram of the GitHub repository yennanliu/investskill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yennanliu/investskill
- Repository: https://github.com/yennanliu/investskill

## Overview

InvestSkill is a prompt library, not a runtime analysis engine: a user asks an AI assistant to apply a framework, and the assistant produces an investment analysis. The README documents stock evaluation and technical analysis, valuation, macro, comparisons, financial-report analysis, and optional SEC data-fetch helpers; the tree shows broader portfolio, trading, risk, learning, and report-generation skills. Skill files are grouped by domain rather than mapped as a call chain. Source excerpts confirm the optional SEC helpers are separate from the plugin; unsampled skill details are represented only at their documented directory paths.

Main entry points: [`plugins/us-stock-analysis/skills`](https://github.com/yennanliu/investskill/tree/main/plugins/us-stock-analysis/skills) (Stock analysis frameworks), [`plugins/us-stock-analysis/skills/technical-analysis/SKILL.md`](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md) (Technical analysis), [`plugins/us-stock-analysis/skills/stock-valuation/SKILL.md`](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md) (Valuation frameworks), [`plugins/us-stock-analysis/skills/economics-analysis/SKILL.md`](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md) (Economics analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Investment analysis"]
  node_core["Stock analysis frameworks"]
  node_technical["Technical analysis<br/>[SKILL.md]"]
  node_valuation["Valuation frameworks<br/>[SKILL.md]"]
  node_macro["Economics analysis<br/>[SKILL.md]"]
  node_comparison["Stock comparison<br/>[SKILL.md]"]
end

subgraph group_research["Research and reports"]
  node_filings["Financial reports<br/>[SKILL.md]"]
  node_filingdigest["10-K digest<br/>[SKILL.md]"]
  node_forensics["Accounting forensics<br/>[SKILL.md]"]
  node_earnings["Earnings analysis<br/>[SKILL.md]"]
end

subgraph group_portfolio["Portfolio and trading"]
  node_portfolio["Portfolio review<br/>[SKILL.md]"]
  node_risk["Risk analysis<br/>[SKILL.md]"]
  node_trading["Trade planning<br/>[SKILL.md]"]
  node_thesis["Thesis tracking<br/>[SKILL.md]"]
end

subgraph group_learning["Learning and output"]
  node_learning["Investing lessons<br/>[LEARNING.md]"]
  node_report["Report generation<br/>[SKILL.md]"]
end

subgraph group_data["Optional data helpers"]
  node_edgar["SEC filing fetcher<br/>[fetch-edgar.js]"]
  node_fundamentals["Fundamentals fetcher"]
end

node_investor(("Investor"))
node_assistant(("AI assistant"))
node_result["Analysis result"]
node_sec[("SEC EDGAR")]

node_investor -->|"asks analysis"| node_assistant
node_assistant -->|"uses framework"| node_core
node_assistant -->|"uses framework"| node_technical
node_assistant -->|"uses framework"| node_valuation
node_assistant -->|"uses framework"| node_macro
node_assistant -->|"uses framework"| node_comparison
node_assistant -->|"uses framework"| node_filings
node_assistant -->|"uses framework"| node_filingdigest
node_assistant -.->|"uses framework"| node_forensics
node_assistant -.->|"uses framework"| node_earnings
node_assistant -.->|"uses framework"| node_portfolio
node_assistant -.->|"uses framework"| node_risk
node_assistant -.->|"uses framework"| node_trading
node_assistant -.->|"uses framework"| node_thesis
node_assistant -.->|"consults guide"| node_learning
node_assistant -.->|"uses framework"| node_report
node_core -->|"guides analysis"| node_result
node_technical -->|"produces analysis"| node_result
node_valuation -->|"produces analysis"| node_result
node_macro -->|"produces analysis"| node_result
node_comparison -->|"produces comparison"| node_result
node_filings -->|"produces findings"| node_result
node_edgar -.->|"fetches filings"| node_sec
node_fundamentals -.->|"fetches facts"| node_sec

click node_core "https://github.com/yennanliu/investskill/tree/main/plugins/us-stock-analysis/skills"
click node_technical "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md"
click node_valuation "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md"
click node_macro "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md"
click node_comparison "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/compare/SKILL.md"
click node_filings "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md"
click node_filingdigest "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/10k-digest/SKILL.md"
click node_forensics "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/forensic-accounting/SKILL.md"
click node_earnings "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md"
click node_portfolio "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md"
click node_risk "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md"
click node_trading "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/position-ladder/SKILL.md"
click node_thesis "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md"
click node_learning "https://github.com/yennanliu/investskill/blob/main/site/content/LEARNING.md"
click node_report "https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/report-generator/SKILL.md"
click node_edgar "https://github.com/yennanliu/investskill/blob/main/scripts/fetch-edgar.js"
click node_fundamentals "https://github.com/yennanliu/investskill/blob/main/scripts/fetch-fundamentals.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core,node_technical,node_valuation,node_macro,node_comparison toneBlue
class node_filings,node_filingdigest,node_forensics,node_earnings,node_sec toneAmber
class node_portfolio,node_risk,node_trading,node_thesis toneMint
class node_learning,node_report toneRose
class node_edgar,node_fundamentals,node_investor,node_assistant,node_result toneIndigo
```

## Components

### Investment analysis

- [Stock analysis frameworks](https://github.com/yennanliu/investskill/tree/main/plugins/us-stock-analysis/skills): `plugins/us-stock-analysis/skills`
- [Technical analysis](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md): `plugins/us-stock-analysis/skills/technical-analysis/SKILL.md`
- [Valuation frameworks](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md): `plugins/us-stock-analysis/skills/stock-valuation/SKILL.md`
- [Economics analysis](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md): `plugins/us-stock-analysis/skills/economics-analysis/SKILL.md`
- [Stock comparison](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/compare/SKILL.md): `plugins/us-stock-analysis/skills/compare/SKILL.md`

### Research and reports

- [Financial reports](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md): `plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md`
- [10-K digest](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/10k-digest/SKILL.md): `plugins/us-stock-analysis/skills/10k-digest/SKILL.md`
- [Accounting forensics](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/forensic-accounting/SKILL.md): `plugins/us-stock-analysis/skills/forensic-accounting/SKILL.md`
- [Earnings analysis](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md): `plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md`

### Portfolio and trading

- [Portfolio review](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md): `plugins/us-stock-analysis/skills/portfolio-review/SKILL.md`
- [Risk analysis](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md): `plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md`
- [Trade planning](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/position-ladder/SKILL.md): `plugins/us-stock-analysis/skills/position-ladder/SKILL.md`
- [Thesis tracking](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md): `plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md`

### Learning and output

- [Investing lessons](https://github.com/yennanliu/investskill/blob/main/site/content/LEARNING.md): `site/content/LEARNING.md`
- [Report generation](https://github.com/yennanliu/investskill/blob/main/plugins/us-stock-analysis/skills/report-generator/SKILL.md): `plugins/us-stock-analysis/skills/report-generator/SKILL.md`

### Optional data helpers

- [SEC filing fetcher](https://github.com/yennanliu/investskill/blob/main/scripts/fetch-edgar.js): `scripts/fetch-edgar.js`
- [Fundamentals fetcher](https://github.com/yennanliu/investskill/blob/main/scripts/fetch-fundamentals.js): `scripts/fetch-fundamentals.js`

### Other components

- **Investor**
- **AI assistant**
- **Analysis result**
- **SEC EDGAR**

## Connections

- Investor → AI assistant: asks analysis (evidence: `README.md`)
- AI assistant → Stock analysis frameworks: uses framework (evidence: `README.md`)
- AI assistant → Technical analysis: uses framework (evidence: `README.md`)
- AI assistant → Valuation frameworks: uses framework (evidence: `README.md`)
- AI assistant → Economics analysis: uses framework (evidence: `README.md`)
- AI assistant → Stock comparison: uses framework (evidence: `README.md`)
- AI assistant → Financial reports: uses framework (evidence: `README.md`)
- AI assistant → 10-K digest: uses framework (evidence: `README.md`)
- AI assistant → Accounting forensics: uses framework
- AI assistant → Earnings analysis: uses framework
- AI assistant → Portfolio review: uses framework
- AI assistant → Risk analysis: uses framework
- AI assistant → Trade planning: uses framework
- AI assistant → Thesis tracking: uses framework
- AI assistant → Investing lessons: consults guide
- AI assistant → Report generation: uses framework
- Stock analysis frameworks → Analysis result: guides analysis (evidence: `README.md`)
- Technical analysis → Analysis result: produces analysis (evidence: `README.md`)
- Valuation frameworks → Analysis result: produces analysis (evidence: `README.md`)
- Economics analysis → Analysis result: produces analysis (evidence: `README.md`)
- Stock comparison → Analysis result: produces comparison (evidence: `README.md`)
- Financial reports → Analysis result: produces findings (evidence: `README.md`)
- SEC filing fetcher → SEC EDGAR: fetches filings
- Fundamentals fetcher → SEC EDGAR: fetches facts