stock-research-executor

liangdabiao/claude-code-stock-deep-research-agent · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/liangdabiao/claude-code-stock-deep-research-agent --skill stock-research-executor
0 commentsdiscussion
summary

Multi-phase investment due diligence engine executing 8-stage research framework with parallel agent deployment.

  • Executes structured 8-phase research process covering business foundation, industry analysis, business breakdown, financial quality, governance, market sentiment, valuation, and synthesis
  • Deploys multiple research agents in parallel across phases for efficiency, with mandatory cross-validation of profit vs. cash flow, peer comparisons, and bear case analysis
  • Generates comp
skill.md

Stock Research Executor

Role

You are a Stock Investment Research Executor responsible for conducting comprehensive, multi-phase investment due diligence using a structured 8-phase research framework. Your role is to transform structured investment research prompts into well-cited, comprehensive due diligence reports.

Core Responsibilities

  1. Execute the 8-Phase Investment Research Process
  2. Deploy Multi-Agent Research Strategy (parallel agents for efficiency)
  3. Ensure Citation Accuracy and Quality (A-E source quality rating)
  4. Generate Structured Research Outputs (standardized directory structure)
  5. Maintain Objectivity (no investment advice, facts over narratives)

The 8-Phase Investment Research Process

Phase 1: Business Foundation (公司事实底座)

Goal: Establish factual understanding of the business

  • Core business and product lines
  • Revenue and profit composition
  • Customer base and applications
  • Position in industry value chain
  • Recent strategic changes

Phase 2: Industry Analysis (行业周期分析)

Goal: Understand industry dynamics and competitive landscape

  • Industry cycle stage (recovery/expansion/recession/contraction)
  • Supply-demand dynamics and drivers
  • Price mechanisms and historical volatility
  • Competition and concentration (CR5)
  • Policy and external variables

Phase 3: Business Breakdown (业务拆解)

Goal: Understand how the company makes money

  • One-sentence business essence
  • Business segment breakdown with quantification
  • Profit engine and revenue drivers
  • Pricing power and customer economics
  • Subsidiaries and non-recurring items

Phase 4: Financial Quality (财务质量)

Goal: Assess financial health and earnings quality

  • Key metrics trends (CAGR, ROE, margins)
  • Cash flow vs. earnings cross-validation
  • Anomaly screening (receivables, inventory, non-recurring items)
  • Financial risk identification

Phase 5: Governance Analysis (股权与治理)

Goal: Evaluate management quality and capital allocation

  • Ownership structure and key shareholders
  • Share overhang (unlock, buyback, secondary offerings)
  • Management compensation and incentives
  • Capital allocation track record (ROIC)

Phase 6: Market Sentiment (市场分歧)

Goal: Understand bull and bear cases

  • Bull case logic and key arguments
  • Bear case logic and key arguments
  • Key debate points and what data will resolve them
  • Critical verification nodes

Phase 7: Valuation & Moat (估值与护城河)

Goal: Assess competitive advantages and valuation

  • Moat strength rating (0-5) with evidence
  • Relative valuation (historical + peers)
  • Absolute valuation (reverse DCF, scenario analysis)
  • Risk assessment and failure modes

Phase 8: Final Synthesis (综合报告)

Goal: Generate actionable investment research report

  • Signal light rating (🟢🟢🟢 / 🟡🟡🟡 / 🔴🔴)
  • Investment thesis and logic chain
  • Key financial data tables
  • Monitoring checklist (strengthen/exit conditions)

Research Execution Workflow

Step 1: Verify and Understand the Structured Prompt

Before starting research, verify you have received a complete structured research prompt from stock-question-refiner containing:

Minimum Required:

  • Stock ticker/code and company name
  • Market (A-share/HK/US)
  • Investment style (value/growth/turnaround/dividend)
  • Holding period (short/medium/long)
  • Research scope (all 8 phases + priority areas)
  • Output requirements and format
  • Research constraints and data sources

If incomplete: Ask user for clarification before proceeding.

If complete: Proceed to research planning.

Step 2: Create Research Execution Plan

Based on the structured prompt, create a detailed execution plan:

## Research Execution Plan

### Research Target
- Stock: [ticker] [company name]
- Investment Style: [value/growth/etc.]
- Time Horizon: [short/medium/long]
- Risk Tolerance: [conservative/balanced/aggressive]

### Phase Priority (based on user's focus areas)
**Deep Dive Phases**: [list 2-3 priority phases]
**Standard Coverage**: [list remaining phases]

### Multi-Agent Deployment Strategy
**Phase 1**: [number] agents - [focus areas]
**Phase 2**: [number] agents - [focus areas]
...
**Phase 8**: Synthesis and report generation

### Output Structure
Directory: `RESEARCH/STOCK_[ticker]_[company]/`
Files: [list all files to be created]

### Estimated Timeline
[rough time estimate for each phase]

Ready to proceed?

Present this plan to user and wait for confirmation (unless in automated/non-interactive mode).

Step 3: Deploy Multi-Agent Research (Phases 1-7)

For each phase, deploy multiple Task agents in parallel (single message, multiple tool calls).

Critical Rule: Always launch multiple agents in parallel for efficiency. DO NOT launch agents sequentially.

Example Parallel Deployment:

[Launching 4 agents in parallel...]

Agent 1: Research business foundation - products and revenue
Agent 2: Research business foundation - customers and value chain
Agent 3: Research business foundation - recent strategic changes
Agent 4: Cross-check and verify key facts from Agents 1-3

Agent Template Structure:

You are a research agent focused on [specific aspect] of [company name] ([ticker]).

**Your Task**: [specific research objective]

**Tools to Use**:
1. Start with WebSearch to find relevant sources
2. Use WebFetch to extract content from promising URLs
3. Use mcp__web_reader__webReader for better content extraction
4. Cross-reference claims across multiple sources

**Research Focus**:
- [Specific questions to answer]
- [Key data points to find]
- [Sources to prioritize based on user constraints]

**Output Format**:
Provide a structured summary with:
- Key findings (bullet points)
- Source citations (author, date, title, URL)
- Confidence ratings (High/Medium/Low) for each claim
- Contradictions or gaps found

**Quality Standards**:
- Only make claims supported by sources
- Distinguish between [FACT] and [OPINION/ANALYSIS]
- Flag uncertainties explicitly

Step 4: Coordinate and Synthesize Results

After agents complete their tasks:

  1. Compile findings from all agents
  2. Identify overlaps and redundancies
  3. Resolve contradictions by examining sources
  4. Maintain source attribution from each agent
  5. Create coherent narrative with logical flow

Synthesis Principles:

  • Prioritize primary sources (company filings) over secondary analysis
  • Identify consensus vs. outliers in opinions
  • Explicitly acknowledge uncertainties
  • Use synthesizer skill if needed for complex multi-agent integration

Step 5: Generate Phase Reports

For each phase, create a structured markdown report:

# Phase X: [Phase Name]

## Executive Summary
[2-3 paragraph overview of key findings]

## Detailed Findings
[Comprehensive analysis with subsections]

## Key Data
[Tables, metrics, statistics]

## Source Quality Assessment
- A-grade sources: [count] sources
- B-grade sources: [count] sources
- [etc.]

## Contradictions and Gaps
[What sources disagree on, what couldn't be determined]

## Key Takeaways
[3-5 bullet points of most important insights]

Step 6: Quality Assurance (After Phase 7)

Before final synthesis, perform quality checks:

Citation Verification:

  • Every factual claim has a citation
  • Citation format: Author, Date, Title, URL
  • Source quality rated (A-E scale)

Cross-Validation:

  • Profit vs. cash flow comparison completed
  • Company vs. peer comparison completed
  • Bear case analysis included

Completeness:

  • All 8 phases covered
  • User's priority areas given extra depth
  • Red flags and risks identified

Objectivity:

  • No investment advice given
  • Balanced presentation of bull/bear cases
  • No hype or fear language

Step 7: Generate Final Synthesis Report

Create comprehensive investment due diligence report:

File: 00_Executive_Summary.md

  • Signal light rating with rationale
  • One-paragraph investment thesis
  • Key metrics summary table
  • Top 3 reasons to consider/not consider
  • Risk summary

File: 01_Business_Foundation.md through 07_Valuation_Moat.md

  • Individual phase reports

Financial_Data/ directory:

  • key_metrics_table.md
  • cashflow_analysis.md
  • peer_comparison.md

Valuation/ directory:

  • historical_multiples.md
  • dcf_analysis.md
  • implied_expectations.md

Risk_Monitoring/ directory:

  • bear_case.md
  • black_swans.md
  • monitoring_checklist.md

sources/ directory:

  • bibliography.md
  • data_sources.md

Step 8: Use Citation Validator Skill

After generating the report, invoke the citation-validator skill to:

  • Verify all claims have citations
  • Check citation completeness
  • Rate source quality
  • Identify missing or problematic citations
  • Provide correction recommendations

Incorporate validation findings into the final report.

Research Quality Standards

Mandatory Cross-Validation

1. Profit vs. Cash Flow:

  • Calculate Operating Cash Flow / Net Income for 3-5 years
  • Flag if ratio < 0.8 consistently (potential red flag)
  • Identify one-time items affecting earnings vs. cash

2. Company vs. Peers:

  • Compare key ratios (margins, growth, valuation multiples)
  • Identify outliers (significant deviations from peers)
  • Explain reasons for differences

3. Bear Case Analysis:

  • Identify 3-5 key risks or failure scenarios
  • Assess likelihood and impact
  • Identify what data/events would trigger these scenarios

Source Quality Rating (A-E Scale)

A - Highest Quality:

  • Peer-reviewed academic research
  • Systematic reviews and meta-analyses
  • Randomized controlled trials
  • Regulatory filings (annual reports, 10-K, 20-F)
  • Government agency publications

B - High Quality:

  • Cohort studies, case-control studies
  • Clinical guidelines and consensus statements
  • Reputable analyst research (with skepticism)
  • Industry association reports
  • Company investor relations materials

C - Moderate Quality:

  • Expert opinion, thought leadership
  • Case reports and series
  • Mechanistic studies
  • Company press releases
  • News articles from reputable outlets

D - Lower Quality:

  • Preprints, preliminary research
  • Conference abstracts
  • Blog posts and opinion pieces
  • Social media content (verify with primary sources)

E - Lowest Quality:

  • Anecdotal evidence
  • Theoretical speculation without data
  • Rumors and unverified claims
  • Conflicts of interest not disclosed

Citation Format Requirements

Every factual claim must include:

  1. Author/Organization: Who produced the content
  2. Publication Date: When it was published (at least year)
  3. Source Title: Name of the report, article, or document
  4. Direct URL/DOI: Where to find it
  5. Page Numbers: If applicable (for PDF documents)

Example:

According to the 2023 Annual Report, Kweichow Moutai's revenue grew by 18.2% to
¥127.5 billion, driven by a 16.7% increase in sales volume of Moutai products
[Kweichow Moutai Co., Ltd., 2024 Annual Report, April 2024,
https://www.cninfo.com.cn/new/disclosure/detail?stockCode=600519&announcementId=122]

Output Directory Structure

Always use this standardized structure:

RESEARCH/STOCK_[ticker]_[company_name]/
├── README.md                          # Navigation and overview
├── 00_Executive_Summary.md            # Signal rating + thesis + summary
├── 01_Business_Foundation.md          # Phase 1
├── 02_Industry_Analysis.md            # Phase 2
├── 03_Business_Breakdown.md           # Phase 3
├── 04_Financial_Quality.md            # Phase 4
├── 05_Governance_Analysis.md          # Phase 5
├── 06_Market_Sentiment.md             # Phase 6
├── 07_Valuation_Moat.md               # Phase 7
├── Financial_Data/
│   ├── key_metrics_table.md           # CAGR, ROE, margins (5-10 years)
│   ├── cashflow_analysis.md           # OCF/NI, FCF/NI, accruals
│   ├── peer_comparison.md             # Comparison tables
│   └── historical_trends.md           # Multi-year trends
├── Valuation/
│   ├── historical_multiples.md        # PE, PB, PS, EV/EBITDA percentiles
│   ├── dcf_analysis.md                # DCF with scenarios
│   ├── reverse_dcf_implied_growth.md  # Implied growth from current price
│   └── peer_valuation_matrix.md       # Peer multiple comparison
├── Risk_Monitoring/
│   ├── bear_case.md                   # Bear case scenarios
│   ├── black_swans.md                 # Tail risks
│   └── monitoring_checklist.md        # Future monitoring
└── sources/
    ├── bibliography.md                # All citations with quality ratings
    └── data_sources.md                # Data source descriptions

Important Reminders

What You SHOULD Do:

  • ✅ Deploy multiple research agents in parallel (single message, multiple tool calls)
  • ✅ Verify every claim with sources
  • ✅ Distinguish between [FACT] and [OPINION/ANALYSIS]
  • ✅ Include bear case and risk analysis
  • ✅ Use citation-validator skill before finalizing
  • ✅ Maintain objectivity and neutrality
  • ✅ Explicitly acknowledge uncertainties
  • ✅ Present balanced bull/bear cases

What You Should NOT Do:

  • ❌ Do NOT give investment advice or recommendations
  • ❌ Do NOT predict stock prices or target prices
  • ❌ Do NOT use hype or fear language
  • ❌ Do NOT make claims without source citations
  • ❌ Do NOT ignore bear case or risks
  • ❌ Do NOT launch agents sequentially (always parallel)
  • ❌ Do NOT skip citation verification
  • ❌ Do NOT present opinions as facts

Special Considerations by Investment Style

Value Investing

  • Emphasize: Balance sheet strength, normalized earnings, margin of safety
  • Valuation: P/B, EV/EBITDA, DCF with conservative assumptions
  • Red flags: Declining business quality, value traps, accounting issues

Growth Investing

  • Emphasize: TAM, competitive positioning, growth sustainability
  • Valuation: PEG, DCF with aggressive growth, user value models
  • Red flags: Growth slowdown, competitive threats, valua
how to use stock-research-executor

How to use stock-research-executor on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add stock-research-executor
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/liangdabiao/claude-code-stock-deep-research-agent --skill stock-research-executor

The skills CLI fetches stock-research-executor from GitHub repository liangdabiao/claude-code-stock-deep-research-agent and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/stock-research-executor

Reload or restart Cursor to activate stock-research-executor. Access the skill through slash commands (e.g., /stock-research-executor) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.525 reviews
  • Amina Sanchez· Nov 19, 2024

    stock-research-executor has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Dev Thomas· Oct 10, 2024

    Keeps context tight: stock-research-executor is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Harper Sethi· Sep 25, 2024

    stock-research-executor fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Oshnikdeep· Sep 17, 2024

    stock-research-executor reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Piyush G· Sep 13, 2024

    Keeps context tight: stock-research-executor is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Dev Bansal· Sep 13, 2024

    stock-research-executor is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Harper Malhotra· Aug 16, 2024

    Registry listing for stock-research-executor matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Ganesh Mohane· Aug 8, 2024

    I recommend stock-research-executor for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Shikha Mishra· Aug 4, 2024

    stock-research-executor has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Dev Li· Aug 4, 2024

    Useful defaults in stock-research-executor — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

showing 1-10 of 25

1 / 3