investskill

InvestSkill

Professional investment analysis frameworks for US stocks — works on every AI platform

No API keys · No subscriptions · 100% free

Documentation · Learn Investing · Cookbook · 繁體中文

---

What is InvestSkill?

InvestSkill is a collection of 30 structured analysis frameworks that turn any AI assistant into an institutional-quality investment analyst. There is no runtime — every skill is a prompt that works in Claude Code, Cursor, Gemini CLI, GitHub Copilot, ChatGPT, or any other LLM.

Nothing to sign up for, nothing to pay for. No API key, no data-vendor subscription, no billing setup — you bring the AI assistant you already use (a free tier or a local model works too) and InvestSkill is just markdown. See No API keys, no cost.

Ask your AI:  "Evaluate AAPL using the stock-eval framework"
Get back:     Piotroski score · ROIC · moat rating · buy/hold/sell signal

---

Quick Start

One command, any AI agent — pick yours on the website:

# Claude Code
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a claude

# Swap the agent: cursor · copilot · gemini · codex · opencode · any
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a cursor

The installer copies every framework into .investskill/prompts/ and wires up your agent's own entry point — nothing else runs on your machine:

-a	Agent	Wires up
claude	Claude Code	.claude/skills/<skill>/SKILL.md (slash commands)
cursor	Cursor	.cursor/rules/investskill.mdc
copilot	GitHub Copilot	.github/copilot-instructions.md
gemini	Gemini CLI	GEMINI.md
codex	Codex	AGENTS.md
opencode	OpenCode	AGENTS.md
any	ChatGPT, Claude.ai, Ollama, …	.investskill/prompts/ only — paste and go

Add -g to install for your user instead of one project, -d DIR to target another directory, or -h for all options. Existing instruction files are appended to, never overwritten, and re-running is a no-op. Read it first if you'd rather not pipe to bash: install.sh.

Claude Code via the plugin marketplace — full slash-command support:

claude
/plugin marketplace add yennanliu/InvestSkill
/plugin install us-stock-analysis
/us-stock-analysis:stock-eval AAPL

Or clone the repo — every framework in prompts/, use it anywhere:

git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill

# Cursor
cursor .
# → @prompts/stock-eval.md Evaluate Apple

# Gemini CLI
gemini
# → @prompts/stock-eval.md Evaluate Apple

# Any LLM — paste the prompt file directly
cat prompts/stock-eval.md | pbcopy

Full platform guides: Claude Code · Cursor · Gemini CLI · Ollama

---

No API Keys, No Cost

InvestSkill is completely free to use — there is nothing to buy, register, or configure.

API keys	None. No OpenAI / Anthropic / Alpha Vantage / Polygon key. The plugin never calls an endpoint — there is no code to call one with.
Subscriptions	None. No paid tier, no seats, no usage metering, no account.
Market-data fees	None. No Bloomberg, no paid data feed. The AI reads public filings and free sources — or you paste the numbers in yourself.
Install / runtime	None. Every skill is a plain markdown prompt. Nothing runs on your machine, so nothing phones home.
License	MIT. Free to use, fork, and modify — for personal or commercial work.

The only thing you need is an AI assistant you already have. That can be a paid plan (Claude Code, Cursor, Copilot), a free tier (ChatGPT, Gemini, Claude.ai), or a fully offline local model via Ollama — in which case the total cost of running every framework is literally zero.

Because there's no API, there's also no telemetry: InvestSkill never sees your tickers, your holdings, or your analysis. See Data & Accuracy for where the numbers actually come from.

Bring your own data. The filing skills (10k-digest, financial-report-analyst, fact-check) carry a keyless SEC EDGAR recipe a tool-enabled assistant can follow by itself. If yours can't browse, two optional zero-dependency scripts fetch the primary source for you to paste — node scripts/fetch-edgar.js AAPL --form 10-K saves the filing as text, node scripts/fetch-fundamentals.js AAPL builds a reconciled statement pack from the SEC's XBRL facts. Neither is part of the plugin. Details on the Data & Accuracy page.

---

The 30 Frameworks

Core Stock Analysis

Skill	What it produces
stock-eval	Piotroski F-Score, ROIC, quality rating, go/no-go signal
technical-analysis	MA chart (30/60/90/200/365d) with trade entry/target/stop, chart patterns, RSI/MACD, MTF alignment, Ichimoku
stock-valuation	P/E · P/S · EV/EBITDA · comparable company multiples
economics-analysis	Macro indicators, recession probability, rate sensitivity

Financial Reports

Skill	What it produces
financial-report-analyst	10-K / 10-Q key findings, red flags, accounting quality
10k-digest	Structured markdown digest — abstract, section summaries, metrics table, refs (EN / 繁中)
earnings-call-analysis	Management tone, guidance delta, hidden risks

Market Monitoring

Skill	What it produces
insider-trading	SEC Form 4 patterns, net buy/sell sentiment
institutional-ownership	13F holdings changes, smart money flows
dividend-analysis	Payout safety score, yield trap detection
short-interest	Short ratio, days-to-cover, squeeze probability

Advanced Research

Skill	What it produces
competitor-analysis	Moat score, Porter's Five Forces, market share
industry-map	Supply/value-chain graph (upstream→downstream), chokepoints, margin-pool migration, second-order ideas
options-analysis	Greeks, IV rank, earnings play strategy selection
portfolio-review	Allocation health, concentration risk scoring, correlation analysis, tax-loss harvesting, rebalancing plan
sector-analysis	Sector rotation signals, valuation tables, seasonality calendar, momentum scoring
stock-screener	Multi-ticker ranking across valuation, quality, momentum, sentiment, and growth; leaderboard + top picks + avoid list
catalyst-calendar	Forward-looking 90-day event calendar: earnings, macro events, catalysts, impact scoring, event-driven strategies
bear-case	Deliberate short-seller red-team: bear thesis, accounting red flags, downside target, thesis-killers (counterevidence for any bull thesis)
position-ladder	Staged entry ladder + trim/re-add cycle for a single holding: share-count floor/ceiling, blended cost basis, wash-sale flags, total-return-vs-buy-and-hold check, thesis-break gate
thesis-tracker	Write, save, and re-check an investment thesis — KPIs with thresholds, invalidation triggers, catalysts, a pre-mortem, and a decision log; --update re-reads the saved file against new data and returns INTACT / WEAKENED / BROKEN
etf-analysis	ETF / index-fund due diligence — expense ratio vs. category, tracking difference, liquidity, holdings concentration and tilt, overlap with your other positions, distribution and capital-gains history, structure warnings, and an ETF-vs-top-holdings comparison, scored as an ETF Fitness Score 0–10
earnings-preview	The before-earnings skill — consensus vs. whisper, 8-quarter beat rate and post-print move distribution, options-implied vs. realized move, what the current price already assumes, the KPIs to watch, and a three-scenario grid (beat-and-raise / beat-and-lower / miss) with expected reaction and a position rule for each
tax-lens	US tax mechanics for a position or portfolio — short- vs. long-term treatment, wash-sale window check, qualified-dividend holding-period test, lot selection (specific-ID vs. FIFO), tax-loss-harvesting pairs, account placement, estimated annual tax drag — plus a --non-us module (W-8BEN, dividend withholding and treaty rates, capital-gains treatment, US estate-tax exposure, UCITS alternatives). Educational only, never tax advice
risk-stress-test	Portfolio and position risk report — beta-weighted exposure, historical scenario replay (2008, March 2020, 2022 rate shock, 2025 tariff shock), parametric VaR / CVaR at 95 / 99 %, max-drawdown estimate, correlation-spike scenario, rate / USD / oil sensitivity, liquidity (days to exit at 20 % of ADV), and a Risk Budget Score 0–10

Meta & Output

Skill	What it produces
full-report	Runs all 15 modules and saves a standalone HTML report
report-generator	Converts any analysis into a professional HTML/PDF report
chart-master	Mermaid · ASCII · Chart.js visualizations from financial data
result-validator	Scores any analysis on data quality, methodology, and signal consistency
learning-coach	Explains any InvestSkill output like a mentor — every metric in plain words, why it matters, its good / bad range, and the lesson that teaches it — then asks 3–5 Socratic questions and "what would change your mind?". --level beginner / intermediate, --lang zh-TW, and a --quiz mode that drills a Learning lesson
fact-check	Claim-level verification of any report or data set — extract every figure and factual claim, check each against a primary source (SEC filing, company IR, FRED, exchange data, or the user's own document), recompute derived numbers, mark ✅ verified / ⚠️ mismatch / ❓ unverifiable, and re-issue the report with inline citations and a References section; Verification Score 0–10

Aliases (redirects)