InvestSkill Cookbook
Practical examples, setup guide, and core concepts for getting the most out of InvestSkill.
Table of Contents
- Setup Guide
- Core Concepts
- Demo Examples & Sample Output
- Practical Workflows
- Cross-AI Usage
- Tips & Best Practices
1. Setup Guide
Prerequisites
- Claude Code installed (
npm install -g @anthropic-ai/claude-code) - An active Anthropic API key
Install InvestSkill (2 minutes)
# Step 1: Open Claude Code
claude
# Step 2: Add the marketplace
/plugin marketplace add yennanliu/InvestSkill
# Step 3: Install the plugin
/plugin install us-stock-analysis@invest-skill
# Step 4: Verify installation
/plugin list
You should see us-stock-analysis in the list with 21 available skills.
Quick Test
# Test with a stock you know
/us-stock-analysis:stock-eval AAPL
If you see analysis output with a BULLISH/NEUTRAL/BEARISH signal block, you’re ready to go.
Local Development Setup
# Clone the repository
git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill
# Open Claude Code in the project directory
claude
# Add local marketplace (use your actual path)
/plugin marketplace add /path/to/InvestSkill
# Install from local source
/plugin install us-stock-analysis@invest-skill
Updating to the Latest Version
# Remove the existing installation
/plugin uninstall us-stock-analysis
# Re-add marketplace (refreshes to latest version)
/plugin marketplace add yennanliu/InvestSkill
# Re-install
/plugin install us-stock-analysis@invest-skill
2. Core Concepts
What InvestSkill Is
InvestSkill is a collection of structured analysis prompt frameworks packaged as a Claude Code plugin. Each skill is a detailed instruction set that tells Claude Code exactly how to analyze a stock, interpret financial data, and present findings in a consistent format.
Think of each skill as a specialized analyst you can summon with a command:
| Command | What it does |
|---|---|
/stock-eval AAPL |
Holistic evaluation: quality, valuation, moat, risk |
/dcf-valuation NVDA |
Rigorous intrinsic value model with 3 scenarios |
/stock-valuation MSFT |
Multi-method valuation: DCF + comps + EV multiples |
/financial-report-analyst GOOGL 10-K |
Deep-read an annual filing, find red flags |
/research-bundle TSLA |
Run all skills in sequence, synthesize into one thesis |
/portfolio-review |
Analyze allocation, performance, and rebalancing needs |
/earnings-call-analysis AMZN |
Parse tone, guidance, and key themes from earnings calls |
/dividend-analysis JNJ |
Check dividend safety, growth, and sustainability |
/chart-master AAPL |
Generate financial charts in Mermaid, ASCII, or HTML |
/full-report MSFT |
Orchestrate all 15 modules into one HTML report |
/result-validator |
Audit any analysis output and produce a confidence score |
How Skills Work
Each skill is defined by a SKILL.md file containing:
- Description (frontmatter): One-line summary used by the plugin system
- Methodology: Step-by-step analysis framework with tables, scoring, and formulas
- Output format: Standardized sections Claude Code follows
- Signal block: Required at the end of every analysis
plugins/us-stock-analysis/skills/
├── stock-eval/SKILL.md
├── dcf-valuation/SKILL.md
├── stock-valuation/SKILL.md
├── financial-report-analyst/SKILL.md
├── chart-master/SKILL.md ← v1.6.0
├── full-report/SKILL.md ← v1.6.0
└── ... (21 skills total)
The Signal Block
Every InvestSkill analysis ends with a standardized signal block for quick decision-making:
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH / NEUTRAL / BEARISH ║
║ Confidence: HIGH / MEDIUM / LOW ║
║ Horizon: SHORT / MEDIUM / LONG-TERM ║
║ Score: X.X / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY / HOLD / SELL ║
║ Conviction: STRONG / MODERATE / WEAK ║
╚══════════════════════════════════════════════╝
Score guide:
- 8.0–10.0 → Strongly Bullish
- 6.0–7.9 → Moderately Bullish
- 4.0–5.9 → Neutral
- 2.0–3.9 → Moderately Bearish
- 0.0–1.9 → Strongly Bearish
Universal Prompts (Cross-AI)
Every skill is also available as a standalone prompt file in the prompts/ directory. These work with any AI assistant — not just Claude Code:
prompts/
├── stock-eval.md
├── dcf-valuation.md
├── stock-valuation.md
├── financial-report-analyst.md
├── chart-master.md
├── full-report.md
└── ... (21 files)
Use them by copying the file content into any AI chat as a system prompt.
3. Demo Examples & Sample Output
Note: The outputs below are representative examples showing the format and depth of analysis. Actual outputs use real-time data and will differ.
3.1 Stock Evaluation
Command:
/us-stock-analysis:stock-eval MSFT
Sample Output:
# US Stock Evaluation — MSFT (Microsoft Corporation)
## Company Overview
Microsoft is a diversified technology company with three major segments:
- Intelligent Cloud (Azure, server products): 43% of revenue, highest growth
- Productivity & Business Processes (Office 365, LinkedIn, Dynamics): 32%
- More Personal Computing (Windows, Xbox, Surface): 25%
Dominant moat: Azure platform lock-in, Office 365 subscription stickiness, enterprise
relationships. Switching costs are extremely high across all segments.
## Financial Health
Revenue Growth (5-yr CAGR): 15.8%
Gross Margin: 70.1% (expanding: +180 bps YoY)
Operating Margin: 44.6% (expanding: +120 bps YoY)
FCF Margin: 37.2%
Net Cash Position: $27.4B (net cash — fortress balance sheet)
## Valuation Metrics
| Metric | Current | 1Y Ago | 5Y Avg | Sector Avg |
|--------------|---------|--------|--------|------------|
| P/E (FWD) | 32.4x | 28.1x | 30.2x | 26.8x |
| EV/EBITDA | 24.1x | 21.5x | 22.8x | 18.4x |
| EV/FCF | 41.2x | 37.8x | 36.5x | 28.1x |
| Price/Sales | 12.8x | 10.9x | 11.6x | 7.2x |
Premium to sector justified by: superior margin profile, cloud growth trajectory,
AI optionality (Copilot, Azure OpenAI).
## Quality Scoring
Piotroski F-Score: 8/9 (Strong — failed only on DTC/shares outstanding)
ROIC: 28.4%
WACC (estimated): 8.9%
ROIC − WACC Spread: +1,950 bps (significant value creation)
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: MEDIUM ║
║ Horizon: LONG-TERM ║
║ Score: 7.2 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.2 DCF Valuation
Command:
/us-stock-analysis:dcf-valuation NVDA --scenarios
Sample Output (condensed):
# DCF Valuation — NVDA (NVIDIA Corporation)
## Base Metrics (TTM)
Revenue: $122.0B FCF: $60.8B
FCF Margin: 49.8% Net Cash: $38.5B
SBC (TTM): $3.5B True FCF*: $57.3B
Shares Outstanding: 24.4B *SBC-adjusted
## WACC Calculation
Cost of Equity: Rf 4.4% + β 1.72 × ERP 5.5% = 13.9%
WACC: 13.8%
## Scenario Assumptions
| Scenario | Probability | Rev CAGR Y1-5 | Rev CAGR Y6-10 | FCF Margin Y10 | Terminal g |
|----------|-------------|---------------|----------------|----------------|------------|
| Bull | 20% | 42% | 18% | 48% | 3.0% |
| Base | 60% | 28% | 10% | 40% | 2.5% |
| Bear | 20% | 12% | 5% | 28% | 1.5% |
## Intrinsic Value Results
| Scenario | IV per Share | vs. Current ($875) | MoS |
|----------|--------------|--------------------|----------|
| Bull | $1,240 | +41.7% | Discount |
| Base | $785 | −10.3% | Premium |
| Bear | $320 | −63.4% | Premium |
| Weighted | $768 | −12.2% | Premium |
## Sensitivity Table (Base Scenario, $ per share)
Terminal Growth Rate
WACC 1.5% 2.0% 2.5% 3.0% 3.5%
11.0% $910 $960 $1,020 $1,090 $1,180
12.0% $830 $875 $920 $975 $1,040
13.8% $710 $745 $785 $825 $875 ← Base Case
15.0% $625 $655 $685 $720 $760
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: NEUTRAL ║
║ Confidence: MEDIUM ║
║ Horizon: LONG-TERM ║
║ Score: 5.8 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: HOLD ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.3 Financial Report Analysis
Command:
/us-stock-analysis:financial-report-analyst AAPL 10-K --section md&a
Sample Output (condensed):
# Financial Report Analysis — AAPL 10-K (FY2024)
## Document Orientation
Filing Type: 10-K Annual Report (FY ended September 28, 2024)
Auditor: Ernst & Young LLP — Unqualified Opinion
Filed: October 25, 2024 (on time)
Restatements: None
## Financial Health Dashboard
┌──────────────────────────┬──────────────────────────────────────┐
│ Revenue Growth │ +2.0% YoY ($391.0B) │
│ Gross Margin │ 46.2% (vs. prior 44.1%, +210 bps) │
│ FCF Margin │ 27.8% (conversion: 108%) │
│ Filing Quality Score │ 9.2 / 10 │
└──────────────────────────┴──────────────────────────────────────┘
## Key Red Flags
• China revenue declined 8% YoY — geopolitical and local competition risk (RISK: HIGH)
• EU Digital Markets Act compliance costs — structural margin risk (RISK: MEDIUM)
## Accounting Quality Score: 19/21 — High quality filing
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: HIGH ║
║ Horizon: LONG-TERM ║
║ Score: 7.8 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.4 Research Bundle
Command:
/us-stock-analysis:research-bundle AMZN
Sample Output (condensed):
# Research Bundle — AMZN (Amazon.com, Inc.)
## Composite Scorecard
| Component | Weight | Sub-Score | Contribution |
|-----------------|--------|-----------|--------------|
| Business Quality| 25% | 8.1 | 2.03 |
| Valuation | 25% | 6.2 | 1.55 |
| Market Signals | 20% | 7.5 | 1.50 |
| Technical Setup | 15% | 6.0 | 0.90 |
| Risk Profile | 15% | 8.0 | 1.20 |
| COMPOSITE | 100% | 7.18/10 | |
## Investment Thesis
Amazon's AWS recovery (re-accelerating to 19% growth) combined with the highest-margin
advertising business scaling to $50B+ creates a powerful earnings leverage story over
the next 3 years.
## Entry / Exit Strategy
Ideal entry: $205–$215 (key support zone on pullback)
Bull target: $275 | Base target: $250 | Stop loss: $195
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: MEDIUM ║
║ Horizon: LONG-TERM ║
║ Score: 7.2 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.5 Technical Analysis
Command:
/us-stock-analysis:technical-analysis TSLA --chart
Sample Output (condensed):
# Technical Analysis — TSLA (Tesla, Inc.)
## Trend Analysis
Primary Trend: BEARISH (price below 200-day MA)
Secondary Trend: NEUTRAL (consolidating above 50-day MA)
MTF Alignment: MIXED → proceed with caution
## Key Levels
Support 1: $195 — Strong (tested 4x, accumulation zone)
Resistance: $240 — Strong (prior breakdown point, now overhead)
## Indicator Signals
| Indicator | Value | Signal |
|----------------|----------|-----------|
| RSI (14) | 48.2 | NEUTRAL |
| MACD | −2.1 | NEUTRAL |
| OBV | Declining| BEARISH |
## Trade Setup
Entry: $197–$202 | Stop: $188 | Target 1: $240 (R/R: 1:3.5)
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: NEUTRAL ║
║ Confidence: LOW ║
║ Horizon: SHORT-TERM ║
║ Score: 4.5 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: HOLD ║
║ Conviction: WEAK ║
╚══════════════════════════════════════════════╝
3.6 Portfolio Review
Command:
/us-stock-analysis:portfolio-review
# Then paste your holdings as a list:
# AAPL 18%, MSFT 15%, NVDA 12%, AMZN 10%, GOOGL 8%, BRK.B 7%, ...
Sample Output (condensed):
# Portfolio Review — Tech-Heavy Growth Portfolio (12 holdings)
## Executive Summary
✅ Strong long-term performance: +22.1% vs. S&P 500 +18.4% (3Y annualized)
⚠️ Concentration risk: Top 3 positions = 45% of portfolio (max recommended: 30%)
⚠️ Zero international exposure — significant geographic blind spot
⚠️ No dividend/income component — purely growth-oriented
## Performance Scorecard
| Metric | Portfolio | S&P 500 | Delta |
|--------------------|-----------|---------|--------|
| YTD Return | +14.2% | +11.8% | +2.4% |
| 1Y Return | +28.6% | +22.1% | +6.5% |
| 3Y Annualized | +22.1% | +18.4% | +3.7% |
| Sharpe Ratio | 1.42 | 1.18 | +0.24 |
| Max Drawdown | −28.4% | −19.4% | −9.0% |
| Beta | 1.35 | 1.00 | +0.35 |
## Asset Allocation vs. Target
| Sector | Current | Target | Action |
|--------------|---------|--------|--------------|
| Technology | 68% | 40% | TRIM −28% |
| Consumer Disc| 14% | 15% | HOLD |
| Comm. Services| 10% | 10% | HOLD |
| Healthcare | 0% | 10% | ADD +10% |
| Financials | 0% | 10% | ADD +10% |
| International| 0% | 15% | ADD +15% |
| Cash | 8% | 5% | DEPLOY −3% |
## Holdings Review (Top 5)
| Ticker | Weight | 1Y Return | Status | Note |
|--------|--------|-----------|---------|-------------------------------|
| AAPL | 18% | +12.4% | TRIM | Overweight; reduce to 10% |
| MSFT | 15% | +31.2% | HOLD | Core position, justified |
| NVDA | 12% | +89.4% | TRIM | Elevated after run; take 5% |
| AMZN | 10% | +28.1% | HOLD | AWS recovery thesis intact |
| GOOGL | 8% | +18.6% | HOLD | AI monetization optionality |
## Priority Action List
1. Trim AAPL from 18% → 10% (tax-loss pair with any unrealized losses)
2. Trim NVDA from 12% → 7% (lock in gains, reduce concentration)
3. Initiate VTI/VXUS for international diversification (~15%)
4. Add healthcare exposure via XLV or individual name (~10%)
5. Deploy 3% cash into financials (JPM or XLF) given rate environment
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: NEUTRAL ║
║ Confidence: HIGH ║
║ Horizon: MEDIUM-TERM ║
║ Score: 5.5 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: HOLD (rebalance needed) ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.7 Earnings Call Analysis
Command:
/us-stock-analysis:earnings-call-analysis META Q4-2024
# Then paste the earnings call transcript
Sample Output (condensed):
# Earnings Call Analysis — META (Meta Platforms) Q4 2024
## Sentiment Dashboard
Overall Tone: POSITIVE (score: 7.8/10)
Management Confidence: HIGH
Guidance Quality: SPECIFIC (quantitative targets given)
Analyst Reception: NEUTRAL-TO-POSITIVE (no hostile questioning)
## Key Themes (by frequency)
| Theme | Mentions | Sentiment | Implication |
|---------------------|----------|------------|--------------------------------------|
| AI infrastructure | 34 | Very Bullish| Massive capex commitment ($60-65B) |
| Reels monetization | 18 | Bullish | Engagement → revenue conversion |
| Llama adoption | 14 | Bullish | Developer ecosystem building |
| Reality Labs losses | 9 | Cautious | $5B+ annual losses continue |
| Regulatory risks | 7 | Neutral | EU DMA, FTC mentioned briefly |
## Guidance Analysis
| Metric | Q1 2025 Guide | Consensus Est. | Beat/Miss |
|-----------------|----------------|----------------|-----------|
| Revenue | $36.5–$39.0B | $38.2B | In-line |
| Capex | $60–65B (FY) | $52B | ABOVE |
| DAU Growth | "continued growth" | +4% | Vague |
⚠️ Capex guide $8-13B above consensus — markets may react negatively short-term
but signals long-term AI infrastructure investment conviction.
## Language Shift vs. Prior Quarter
INCREASED mentions: "AI", "infrastructure", "efficiency" (+22 mentions combined)
DECREASED mentions: "metaverse", "VR" (−14 mentions) — strategic pivot confirmed
NEW language: "superintelligence", "AGI timeline" — CEO tone more ambitious
## Management Credibility Check
Prior guidance accuracy:
Q3 Revenue Guide: $38.5–$41.0B → Actual: $40.6B ✅ (beat midpoint)
Capex Guide (FY24): $37–40B → Actual: $38.0B ✅ (on target)
Credibility Score: 8.5/10 — Highly reliable guidance history
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: MEDIUM ║
║ Horizon: LONG-TERM ║
║ Score: 7.0 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.8 Dividend Analysis
Command:
/us-stock-analysis:dividend-analysis JNJ
Sample Output (condensed):
# Dividend Analysis — JNJ (Johnson & Johnson)
## Dividend Profile
Current Yield: 3.1%
Annual Dividend: $4.96/share
Consecutive Years: 62 years (Dividend King)
5Y Dividend CAGR: 5.8%
Next Ex-Dividend Date: Approx. Feb 18 (quarterly)
## Safety Scorecard
| Factor | Value | Assessment |
|----------------------------|----------|---------------|
| Payout Ratio (EPS) | 44.2% | SAFE (< 60%) |
| Payout Ratio (FCF) | 38.8% | VERY SAFE |
| Dividend / Net Income | 44% | Comfortable |
| Debt/EBITDA | 1.2x | Low leverage |
| Interest Coverage | 18.4x | Very strong |
| FCF Growth (3Y CAGR) | +7.2% | Healthy |
Dividend Safety Score: 9.1/10 — VERY SAFE
## Growth Trajectory
Year Dividend YoY Growth
2020 $4.04 +5.7%
2021 $4.24 +5.0%
2022 $4.52 +6.6%
2023 $4.76 +5.3%
2024 $4.96 +4.2%
2025E $5.20E +4.8%E (projected)
## Risk Factors
• Litigation overhang: talc baby powder settlements — ongoing but ring-fenced
• MedTech segment growth slowing (orthopedics competition from Stryker)
• Spinoff of Kenvue (consumer health) reduces revenue diversification
## Peer Comparison (Dividend Yield vs. Safety)
| Company | Yield | Safety Score | 5Y DGR |
|---------|-------|--------------|--------|
| JNJ | 3.1% | 9.1/10 | 5.8% |
| ABT | 2.1% | 8.4/10 | 7.2% |
| MDT | 3.5% | 7.8/10 | 4.1% |
| PFE | 6.8% | 5.2/10 | 2.8% |
JNJ offers the best safety-to-yield balance in healthcare.
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: HIGH ║
║ Horizon: LONG-TERM ║
║ Score: 7.5 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.9 Chart Master
Command:
/us-stock-analysis:chart-master AAPL --type price-volume
Sample Output:
# Chart Master — AAPL Price + Volume (6-Month)
## Mermaid Chart (primary — renders in Claude Code, GitHub, Notion)
xychart-beta
title "AAPL — 6-Month Price & Volume"
x-axis ["Aug", "Sep", "Oct", "Nov", "Dec", "Jan", "Feb"]
y-axis "Price (USD)" 160 --> 240
bar [145, 138, 152, 168, 181, 175, 195]
line [162, 155, 171, 184, 196, 188, 212]
## ASCII Chart (fallback — works in any terminal or plain text output)
AAPL — 6M Price (Aug–Feb)
240 | *
220 | * * *
200 | * *
180 | * * *
160 | * * * *
140 | * * * *
+------------------------------------------
Aug Sep Oct Nov Dec Jan Feb
Volume Bars:
HIGH ████████████░░░░░░░░████████░░░░░░░░████████
Aug Sep Oct Nov Feb
NOTE: ████ = above avg volume | ░░░░ = below avg
## Key Chart Observations
• Breakout above $195 resistance on above-average volume (Feb) — bullish confirmation
• Price crossed above 50-day MA in January — trend reversal signal
• Volume contraction during Oct–Nov pullback — healthy consolidation, not distribution
• Support zone: $178–$182 (tested twice, held both times)
## HTML Chart (interactive — paste into browser or export to report)
<!-- Chart.js snippet — opens in any browser -->
<canvas id="aaplChart"></canvas>
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
<script>
new Chart(document.getElementById('aaplChart'), {
type: 'bar',
data: {
labels: ['Aug','Sep','Oct','Nov','Dec','Jan','Feb'],
datasets: [
{ type: 'line', label: 'Price', data: [162,155,171,184,196,188,212],
borderColor: '#3b82f6', tension: 0.3, yAxisID: 'y' },
{ type: 'bar', label: 'Volume (M)', data: [82,65,91,55,78,105,112],
backgroundColor: 'rgba(99,102,241,0.4)', yAxisID: 'y1' }
]
}
});
</script>
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: MEDIUM ║
║ Horizon: SHORT-TERM ║
║ Score: 6.8 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
Other chart types you can request:
/chart-master NVDA --type fair-value-range # Bull/base/bear valuation bands
/chart-master MSFT --type multi-factor-signal # Radar chart of 6 signal dimensions
/chart-master AMZN --type revenue-breakdown # Bar chart of segment revenue
/chart-master TSLA --type rsi-macd # Technical indicator dual-panel
3.10 Full Report
Command:
/us-stock-analysis:full-report MSFT
What it does:
The full-report skill orchestrates 15 analysis modules sequentially and saves a single professional HTML report to output/MSFT-full-report.html.
# Full Report — MSFT (Microsoft Corporation)
Orchestrating analysis modules...
✅ 1/15 — Stock Evaluation (business quality, moat)
✅ 2/15 — Fundamental Analysis (income statement, balance sheet, FCF)
✅ 3/15 — DCF Valuation (3-scenario intrinsic value)
✅ 4/15 — Stock Valuation (comps, EV multiples, football field)
✅ 5/15 — Competitor Analysis (moat vs. peers: GOOGL, AMZN, CRM)
✅ 6/15 — Technical Analysis (trend, key levels, indicators)
✅ 7/15 — Earnings Call Analysis (last 2 quarters, tone delta)
✅ 8/15 — Insider Trading (Form 4 activity, 6 months)
✅ 9/15 — Institutional Ownership (13F changes, smart money)
✅ 10/15 — Short Interest (days-to-cover, squeeze risk)
✅ 11/15 — Options Analysis (implied vol, put/call, unusual activity)
✅ 12/15 — Dividend Analysis (yield, safety, growth)
✅ 13/15 — Economics Analysis (macro tailwinds/headwinds)
✅ 14/15 — Portfolio Impact (how MSFT fits a typical portfolio)
✅ 15/15 — Chart Master (price, valuation range, factor radar)
Report saved to: output/MSFT-full-report.html
Open: open output/MSFT-full-report.html
## Report Contents
- Interactive Chart.js visualizations (price + volume, fair-value range)
- Tabbed layout: Summary | Fundamentals | Valuation | Technicals | Risk
- Printable PDF-ready styling
- Signal blocks for each module + composite signal
## Composite Signal
Across 15 modules: 9 BULLISH | 5 NEUTRAL | 1 BEARISH
Weighted composite score: 7.1/10
╔══════════════════════════════════════════════╗
║ INVESTMENT SIGNAL ║
╠══════════════════════════════════════════════╣
║ Signal: BULLISH ║
║ Confidence: HIGH ║
║ Horizon: LONG-TERM ║
║ Score: 7.1 / 10 ║
╠══════════════════════════════════════════════╣
║ Action: BUY ║
║ Conviction: MODERATE ║
╚══════════════════════════════════════════════╝
3.11 Result Validator
Command:
/us-stock-analysis:result-validator
# Then paste any InvestSkill analysis output for auditing
Use case: Run this after any analysis to get a second opinion on whether the output is reliable.
Sample Output:
# Result Validator — Auditing: NVDA DCF Valuation
## Audit Dimensions
| Dimension | Score | Notes |
|------------------------|-------|----------------------------------------------------|
| Data Quality | 7/10 | Revenue/FCF sourced, WACC assumptions need cite |
| Methodology Soundness | 8/10 | Standard 2-stage DCF, SBC adjustment done |
| Signal Consistency | 6/10 | DCF says HOLD but narrative skews bullish — gap |
| Risk Coverage | 7/10 | Downside scenarios present; tail risk underweighted|
| Reasoning Transparency | 8/10 | Sensitivity table provided, terminal value % shown |
## Issues Found
⚠️ SIGNAL INCONSISTENCY: Score is 5.8/10 (Neutral/Hold) but analysis prose
contains predominantly bullish language. Recommendation may be biased upward.
⚠️ DATA GAP: WACC beta of 1.72 is not sourced — 30-day beta vs. 5-year beta
could shift IV by ±$80/share. Verify input.
⚠️ RISK UNDERWEIGHT: Custom silicon risk from hyperscalers (Google TPU, Amazon
Trainium) mentioned briefly but not quantified in bear case. Bear IV may be
optimistic at $320.
## Adjustments Recommended
• Revise Action from HOLD to HOLD-with-caution (given signal-narrative gap)
• Re-run DCF with 5-year average beta (1.45) as sensitivity check
• Add hyperscaler chip risk scenario to bear case
## Confidence Score
╔═══════════════════════════════════════╗
║ CONFIDENCE ASSESSMENT ║
╠═══════════════════════════════════════╣
║ Raw Score: 5.8 / 10 ║
║ Adjusted Score: 5.2 / 10 ║
║ Tier: MEDIUM ║
║ Reliability: Use with caution ║
╠═══════════════════════════════════════╣
║ Recommendation: Re-verify WACC input ║
║ before acting ║
╚═══════════════════════════════════════╝
4. Practical Workflows
Real-world investor scenarios showing how to combine multiple skills.
Workflow A — Pre-Earnings Deep Dive
Scenario: Earnings are in 3 days. You want to know if the setup is worth holding through.
# Step 1: Check analyst expectations vs. historical beats
/us-stock-analysis:earnings-call-analysis AAPL Q3-2024
# Look for: guidance accuracy track record, tone shift, beats/misses
# Step 2: Scan options market for implied move
/us-stock-analysis:options-analysis AAPL
# Look for: implied volatility rank, straddle price, unusual put/call activity
# Step 3: Check insider activity before lockout
/us-stock-analysis:insider-trading AAPL
# Look for: any CEO/CFO purchases or unusual sales in past 60 days
# Step 4: Technical setup — is the stock at a good risk/reward level?
/us-stock-analysis:technical-analysis AAPL
# Look for: proximity to support/resistance, whether it's overbought into earnings
# Decision matrix:
# - Positive earnings tone history + low IV rank + insider buys + at support = Hold through
# - Negative tone shift + high IV rank + insider sales + at resistance = Reduce before
Workflow B — Value Stock Screening
Scenario: You found a stock that looks cheap on P/E. Is it a value trap or a genuine opportunity?
# Step 1: Quality check first — cheap can stay cheap if the business is bad
/us-stock-analysis:stock-eval INTC
# Look for: Piotroski F-score, ROIC vs. WACC, moat assessment
# Step 2: Understand why it's cheap
/us-stock-analysis:competitor-analysis INTC
# Look for: market share trends, moat erosion, competitive threats
# Step 3: Read the last annual report for red flags
/us-stock-analysis:financial-report-analyst INTC 10-K
# Look for: risk factor changes, management tone, accounting quality
# Step 4: Build the valuation with appropriate discount
/us-stock-analysis:dcf-valuation INTC --scenarios
# Use conservative assumptions — if it's still cheap, that's interesting
# Step 5: Validate the output
/us-stock-analysis:result-validator
# Paste the DCF output — check if assumptions are defensible
# Value trap signals: ROIC < WACC, moat eroding, FCF declining, management tone defensive
# Genuine value signals: ROIC > WACC, short-term headwind, improving FCF, insider buying
Workflow C — Dividend Portfolio Construction
Scenario: Building a dividend income portfolio and evaluating 3 candidates.
# Evaluate each candidate for dividend safety and growth
/us-stock-analysis:dividend-analysis JNJ
/us-stock-analysis:dividend-analysis ABBV
/us-stock-analysis:dividend-analysis PG
# For each: note Safety Score, 5Y DGR, Payout Ratio, and Yield
# Build a comparison table:
# Ticker | Yield | Safety | 5Y DGR | Payout Ratio | Decision
# JNJ | 3.1% | 9.1 | 5.8% | 38% | Core
# ABBV | 4.2% | 7.2 | 8.1% | 52% | Satellite
# PG | 2.5% | 9.4 | 5.2% | 61% | Core
# Check portfolio-level impact
/us-stock-analysis:portfolio-review
# Add the 3 positions and see how they affect overall yield and sector balance
# Tip: Target portfolio yield of 3%+ with average Safety Score > 7.5
Workflow D — Swing Trade Setup
Scenario: Looking for a short-term technical trade with defined risk.
# Step 1: Screen for short squeeze potential
/us-stock-analysis:short-interest GME
# Look for: short float > 20%, days-to-cover > 5, borrow rate rising
# Step 2: Confirm with technicals
/us-stock-analysis:technical-analysis GME
# Look for: price above 20-day MA, RSI recovering from oversold, volume surge
# Step 3: Options setup for defined risk
/us-stock-analysis:options-analysis GME
# Look for: call skew, low-cost entry strikes, OI building above current price
# Step 4: Visualize the setup
/us-stock-analysis:chart-master GME --type price-volume
# Look for: breakout pattern, volume confirmation
# Trade structure: long call or call spread to cap risk to premium paid
# Exit: price target (resistance) or time stop (2-4 weeks max for swing)
Workflow E — Full Investment Memo (1-command)
Scenario: You want a complete investment memo for a stock before a significant position.
# One command — produces a full HTML report with all 15 analysis modules
/us-stock-analysis:full-report NVDA
# Opens as: output/NVDA-full-report.html
# Includes: all signal blocks, interactive charts, football field valuation,
# sector comparison, risk matrix, entry/exit strategy
# After reading, validate the composite output:
/us-stock-analysis:result-validator
# Paste the composite signal block — get a confidence score and any gaps flagged
Workflow F — Macro-Driven Sector Rotation
Scenario: Rates are rising and you want to understand which sectors benefit.
# Step 1: Understand current macro regime
/us-stock-analysis:economics-analysis
# Look for: yield curve shape, Fed language, leading indicators, inflation trend
# Step 2: Identify which sectors historically outperform in this environment
/us-stock-analysis:sector-analysis
# Look for: rate-sensitive vs. rate-beneficiary sectors, relative strength
# Step 3: Pick a stock within the favored sector
/us-stock-analysis:stock-eval JPM # Financials benefit from higher rates
/us-stock-analysis:stock-eval XOM # Energy benefits from inflation regime
# Step 4: Check the portfolio impact of the rotation
/us-stock-analysis:portfolio-review
# Paste current holdings — see if adding JPM/XOM reduces rate sensitivity
5. Cross-AI Usage
InvestSkill works with any AI assistant. The prompts/ directory contains all 21 analysis frameworks as standalone files.
Gemini CLI
# GEMINI.md is automatically loaded by Gemini CLI
cd /path/to/InvestSkill
gemini
# Reference a prompt directly
> @prompts/stock-valuation.md Analyze AAPL using all valuation methods
# Paste a 10-K section for analysis
> @prompts/financial-report-analyst.md
> [paste your 10-K text here]
# Generate a chart
> @prompts/chart-master.md Create a fair-value range chart for NVDA
GitHub Copilot
The .github/copilot-instructions.md file is automatically loaded as workspace context.
# In Copilot Chat (VSCode or github.com)
Analyze NVDA using the stock-valuation framework
# Reference a specific prompt
Use the framework in @workspace /prompts/dcf-valuation.md to value MSFT
# Portfolio review
Use @workspace /prompts/portfolio-review.md to evaluate this portfolio: [paste holdings]
Cursor
The .cursor/rules/invest-skill.mdc file is auto-applied in Cursor.
# Cursor AI Chat
@prompts/fundamental-analysis.md Analyze GOOGL's financial statements
# Or just ask naturally — Cursor knows the frameworks
Run a DCF valuation of AMZN using the InvestSkill methodology
# Full report
@prompts/full-report.md Generate a complete investment report for TSLA
Any AI (ChatGPT, Claude.ai, etc.)
# 1. Copy the content of any prompt file
cat prompts/stock-eval.md | pbcopy # macOS
# 2. Paste into any AI chat as a system prompt or at conversation start
# 3. Ask your question
"Analyze AAPL using this framework"
6. Tips & Best Practices
Getting Better Results
Be specific about the company and context:
# Good
/stock-eval NVDA # Clear ticker
/dcf-valuation MSFT --scenarios # With flag for richer output
# Even better — add context
/financial-report-analyst AAPL # Then paste the actual 10-K text
/earnings-call-analysis META # Then paste the transcript
Chain skills for deeper analysis:
# Step 1: Get the fundamentals
/fundamental-analysis MSFT
# Step 2: Value the business
/dcf-valuation MSFT --scenarios
# Step 3: Check competitive position
/competitor-analysis MSFT
# Step 4: Validate the output
/result-validator # paste the analysis — catch gaps before acting
# Step 5: Or run everything at once
/research-bundle MSFT
# Or generate a full HTML report:
/full-report MSFT
Choosing the Right Skill
| Your Question | Best Skill |
|---|---|
| “Is this stock cheap or expensive?” | /dcf-valuation + /stock-valuation |
| “Is this a good business?” | /stock-eval + /competitor-analysis |
| “What’s in this earnings report?” | /financial-report-analyst |
| “What did management say on the call?” | /earnings-call-analysis |
| “What are insiders doing?” | /insider-trading |
| “Is this dividend safe?” | /dividend-analysis |
| “Where is the stock technically?” | /technical-analysis |
| “Full deep-dive before I invest” | /research-bundle or /full-report |
| “Is this a squeeze candidate?” | /short-interest |
| “Is my portfolio balanced?” | /portfolio-review |
| “Can I trust this analysis?” | /result-validator |
| “I need a chart for my report” | /chart-master |
Interpreting Signal Scores
The 0–10 score is a composite that should be used as one input, not a definitive answer:
- Score 8+: Strong conviction. Multiple signals aligned. Still requires risk management.
- Score 6–8: Moderate conviction. Mostly positive with some concerns. Appropriate for normal position sizing.
- Score 4–6: Neutral. Mixed signals. Consider waiting for clarity or reducing position size.
- Score 2–4: Bearish lean. More concerns than positives. Avoid new long positions.
- Score < 2: Strong bear case. Multiple red flags. Consider avoiding or hedging.
Using with Real Financial Data
For best results, provide the AI with actual data:
- Paste financial statements from the company’s IR page
- Attach 10-K/10-Q PDFs when using the
financial-report-analystskill - Provide specific numbers (revenue, margins, share count) for DCF accuracy
- Reference earnings call transcripts with the
earnings-call-analysisskill - Give your holdings list when running
portfolio-review
Validating AI-Generated Analysis
AI analyses can contain plausible-sounding but incorrect assumptions. Best practices:
- Always run
/result-validatorafter a DCF or complex valuation - Cross-check key numbers (revenue, margins) against the company’s actual filings
- Treat a HIGH confidence score as “worth acting on with normal sizing” — not a guarantee
- When scores are 4–6 (Neutral), the AI is genuinely uncertain — match your conviction to that
Disclaimer
InvestSkill provides educational analysis frameworks only. Nothing in this project constitutes financial advice. All outputs are AI-generated analyses based on the methodologies embedded in the skills — they are not guarantees of future performance. Always consult a qualified financial advisor before making investment decisions.