Skip to content
cccskills
FreePublished on GitHub

report-generate

Turn stock, industry, strategy, or backtest research into structured Markdown reports. Present conclusions, supporting data, ratings, risks, and recommendations using consistent tables and terminology, with PDF delivery supported through the specified rendering tool.

OriginalShow the original description

Professional financial research report generation — standard structure (summary / views / main body / risks / recommendation), Markdown formatting standards, rating system, and terminology guide.

See how to install

Good for

  • Write a detailed stock research report
  • Organize an industry or market outlook
  • Report results from tests on historical trading data
  • Prepare a brief note on a market event

Files included (1)

  • SKILL.md10.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Professional Research Report Generation

Overview

Generate structured, professional-grade financial research reports. Follow the conventions used by securities firms and asset managers, and output complete Markdown reports that can be used directly for investment research reference.

Saving and Delivering a PDF

When the user requests a PDF, send the complete Markdown report to write_file with a .pdf target (prefer artifacts/report.pdf under the active run directory). The tool renders a real, paginated PDF without requiring system Pango/Cairo. Check its returned status, path, and bytes_written; include the returned download_url as a Markdown link labelled with the report's filename. The Web chat downloads it with authentication and IM channels attach the generated PDF. A successful write is evidence that the returned path exists; another path's earlier rejection does not invalidate it. If rendering fails, report that tool error instead of claiming the PDF was created. Do not write HTML or base64 data as the content of a .pdf file.

Report Types and Structure

Type Classification

TypeLengthCore ContentTrigger Scenario
Deep-dive stock report3000-5000 wordsCompany analysis + valuation + rating"Analyze stock XX"
Industry research2000-4000 wordsIndustry structure + trend + recommended names"How is sector XX?"
Strategy report1500-3000 wordsMacro + strategy + allocation recommendation"What is the market outlook?"
Backtest report1000-2000 wordsStrategy performance + risk + improvement suggestionsAfter a backtest is completed
Flash comment / note500-1000 wordsEvent commentary + impact + action suggestion"How should we view event XX?"

Standard Structure Template

# [Report Title]

> **Rating**: Buy | **Target Price**: ¥XX | **Current Price**: ¥XX
> **Analyst**: Vibe-Trading | **Date**: 2026-03-28

## Summary

3-5 key points, each 1-2 sentences, covering the core conclusion.
Use explicit language such as bullish / bearish / neutral. Do not be vague.

## Core Views

### View 1: [One-line heading]
2-3 paragraphs of discussion, supported by data.

### View 2: [One-line heading]
2-3 paragraphs of discussion, supported by data.

### View 3: [One-line heading]
2-3 paragraphs of discussion, supported by data.

## Main Analysis

### [Section 1: for example Industry analysis / Company fundamentals / Strategy logic]
Detailed analysis...

### [Section 2: for example Financial analysis / Competitive landscape / Backtest results]
Detailed analysis...

### [Section 3: for example Valuation analysis / Catalysts / Risk-reward]
Detailed analysis...

## Data Appendix

Key data tables...

## Risk Warnings

1. [Risk 1]: specific description + trigger condition + impact level
2. [Risk 2]: ...
3. [Risk 3]: ...

## Investment Recommendation

Clear action recommendation, including direction, position size, and time horizon.

---
*Disclaimer: This report is generated by an AI quantitative system for research reference only and does not constitute investment advice.*

Rating System

Equity Ratings

RatingDefinitionExpected Return (12 months)Use Case
Strong BuyClearly bullish, high conviction>30%Undervalued + catalyst + favorable trend
BuyBullish, reasonably high conviction15%-30%Improving fundamentals + fair valuation
NeutralNo clear directional edge-5%~15%Fair valuation but lacks catalysts
AvoidBearish<-5%Overvaluation / deteriorating fundamentals

Strategy Ratings

RatingDefinitionApplicable Standard
High allocation priorityExcellent risk-reward profileSharpe > 1.5, max drawdown < 20%
AllocatableGood risk-reward profileSharpe > 1.0, max drawdown < 30%
WatchNeeds more validationSharpe 0.5-1.0
Not recommendedPoor risk-reward profileSharpe < 0.5 or drawdown > 40%

Markdown Formatting Standards

Heading Hierarchy

# H1: Report title (only one)
## H2: Main sections (summary / views / body / risks / recommendation)
### H3: Subsections
#### H4: Maximum depth; use bold text instead of deeper nesting

Table Standards

| Metric | 2024A | 2025E | 2026E | Notes |
|------|-------|-------|-------|------|
| Revenue (100m RMB) | 500.2 | 580.0 | 660.0 | +15% YoY |
| Net profit (100m RMB) | 45.3 | 55.0 | 65.0 | +22% YoY |
| PE(TTM) | 25.0x | 20.5x | 17.3x | Valuation compressing |

Table rules:

  • Right-align numbers where possible (when Markdown cannot do so, at least keep visual alignment clean)
  • Put units in the header (100m / 10k / RMB)
  • Forecast values use E (2025E), actual values use A (2024A)
  • Keep 1 decimal place for percentages and 1-2 decimal places for monetary values

Number Formatting Standards

TypeFormatExample
PercentageX.X%Return 12.5%
Large amountX,XXX.X亿Market cap 1,234.5亿
Small amountX.XX元Stock price 25.80元
MultipleX.XxPE 20.5x
DateYYYY-MM-DD2026-03-28
Time rangeYYYY.MM-YYYY.MM2024.01-2025.03

Chart Substitute (Text Description + Data Table)

Since Markdown output cannot embed images, use the following substitute:

### Equity Curve

The strategy equity started at 1.00 in 2020-01, peaked at 1.85 in 2021-02,
then suffered its largest drawdown from 2022.04 to 2022.10 (-25.3%), and
recovered by 2023.06 to a new high of 2.10.

| Time Point | Equity | Cumulative Return | Phase Event |
|---------|------|---------|---------|
| 2020-01 | 1.00 | 0% | Start |
| 2021-02 | 1.85 | +85% | Bull-market peak |
| 2022-10 | 1.38 | +38% | Drawdown low |
| 2023-06 | 2.10 | +110% | Recovery to new high |
| 2024-12 | 2.45 | +145% | Latest |

Professional Terminology Guide

Terms You Should Use (to improve professionalism)

ScenarioProfessional ExpressionAvoid
Price downpullback / correction / drawdowndropped / fell
Price upstrengthened / rebounded / recovered / climbedrose / went up
Uncertaintyuncertainty remains / needs monitoringhard to say / cannot tell
Recommend buyingrecommend overweight / addbuy now
Recommend sellingrecommend underweight / avoidsell now
Undervaluedvaluation offers a margin of safetycheap
Expensivevaluation premium is elevatedexpensive
Trend favorableconditions are improving / trend is constructivemarket looks okay

Common Abbreviations

AbbreviationFull NameChinese Meaning
YoYYear over Year同比
QoQQuarter over Quarter环比
MoMMonth over Month月环比
TTMTrailing Twelve Months滚动12个月
CAGRCompound Annual Growth Rate复合增长率
ROEReturn on Equity净资产收益率
EPSEarnings Per Share每股收益
FCFFree Cash Flow自由现金流

Backtest Report Template

After a backtest is completed, read the engine-written metrics.csv and equity.csv from that run. Declare reported measurements with the run directory or exact engine field as their grounding reference. A metrics file you write yourself is not evidence, and a previous run's archive cannot substantiate the current call. For list results, use the exact element reference (for example, call_id::data.positions[0].contribution_pct); correction hints only identify candidates to check and cite explicitly.

Use the verified output to generate:

# Backtest Report: [Strategy Name]

## Strategy Overview
- **Strategy type**: momentum / mean reversion / multi-factor / ...
- **Instruments**: 000001.SZ, 600519.SH, ...
- **Backtest period**: 2016-01-01 to 2026-01-01
- **Initial capital**: ¥1,000,000

## Performance Summary

| Metric | Strategy | Benchmark (CSI 300) | Excess |
|------|------|-------------|------|
| Cumulative return | +145.2% | +35.6% | +109.6% |
| Annualized return | 9.8% | 3.2% | +6.6% |
| Sharpe | 1.25 | 0.45 | - |
| Max drawdown | -18.5% | -32.4% | - |
| Calmar | 0.53 | 0.10 | - |
| Win rate | 58.3% | - | - |
| Trade count | 245 | - | - |

## Annual Performance

| Year | Return | Benchmark | Excess | Max Drawdown |
|------|------|------|------|---------|
| 2016 | +12.3% | -8.5% | +20.8% | -8.2% |
| ... | ... | ... | ... | ... |

## Risk Analysis
[Insert output from the `risk-analysis` skill]

## Improvement Suggestions
1. Specific suggestion 1...
2. Specific suggestion 2...

## Rating: Allocatable
Sharpe > 1.0 and max drawdown < 20%, indicating a good risk-reward profile.

Analysis Framework

Preparation Before Writing

  1. Clarify the report type: stock / industry / strategy / backtest / flash note
  2. Collect data: backtest results, fundamentals, industry data
  3. Determine the core view: decide the conclusion first, then organize the supporting arguments
  4. Choose the rating: based on quantitative metrics + qualitative judgment

Writing Principles

  1. Put the conclusion first: the summary should contain the most important views, without too much buildup
  2. Let data speak: every view should have at least one supporting data point
  3. Keep logic clear: because A (data) → therefore B (judgment) → recommendation C (action)
  4. Argue both sides: even in bullish reports, discuss risks; even in bearish reports, mention possible catalysts
  5. Be actionable: recommendations should specify instruments / position sizing / time frame

Output Format

Output the complete Markdown research report directly, following the template structure above. Ensure that:

  • it has a clear rating
  • it is supported by quantitative data
  • it includes at least 3 risk warnings
  • it contains concrete action recommendations
  • it ends with a disclaimer

Notes

  1. Do not make overly precise forecasts: use ranges rather than single points (target price 25-30 RMB instead of target price 27.5 RMB)
  2. Data consistency: all quoted numbers must be consistent throughout the report and never contradict each other
  3. Mark timeliness: state both the data cut-off date and the report generation date
  4. Disclaimer is mandatory: AI-generated reports must explicitly state that they are not investment advice
  5. Avoid absolutes: "likely" is better than "certain", and "may" is better than "will"
  6. China A-share specific risks: policy risk / delisting risk / goodwill impairment / major-shareholder selling / lock-up expiry
  7. Crypto-specific risks: regulation / smart-contract exploits / liquidity risk / rug pulls

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adr-hshare

FreeSummary

Compare a Chinese company's US depositary receipts, Hong Kong shares, and mainland shares after adjusting for exchange rates and share ratios. Analyze pricing gaps, valuation differences, and delisting risks to support research into its different listings.

  • Compare A-share and H-share pricing gaps
  • Measure ADR premiums against Hong Kong shares
  • Review US delisting risks and Hong Kong listing alternatives
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

akshare

FreeSummary

Retrieve stock prices, futures quotes, exchange rates, and economic indicators with the free Python library AKShare. The skill explains market-specific functions, symbol formats, and data preparation for analysis and testing strategies against historical data.

  • Retrieve historical prices for Chinese, US, and Hong Kong stocks
  • Collect Chinese GDP and consumer price data
  • Check futures quotes and foreign exchange rates
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

alpha-zoo

FreeSummary

Explore bundled libraries of investment factors, signals used to compare securities, and inspect individual formulas and metadata. Evaluate a factor or an entire library across a chosen universe and period, producing aggregate performance statistics and an HTML report.

  • Find bundled momentum or reversal factors
  • Inspect a named factor's formula and metadata
  • Compare a factor library across a chosen universe and period
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

Assess whether a Chinese A-share company may receive ST or *ST risk warnings next financial year. Review financial forecasts, dividends, audit opinions, and regulatory penalties, then report risk severity separately from confidence in the prediction.

  • Reviewing a Chinese A-share company's future ST risk
  • Assessing escalation risk for an existing ST or *ST stock
  • Checking revenue, equity, and dividend warning signs
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

asset-allocation

FreeSummary

Plan portfolio allocations across assets using risk, correlations, return forecasts, and trading costs. Compare five optimization methods, produce settings for config.json, and define rebalancing rules that adjust holdings back toward their target weights.

  • Comparing allocations across stocks, bonds, and gold
  • Choosing an optimizer based on return forecasts and correlations
  • Preparing portfolio settings for config.json
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

Diagnose failed or abnormal backtests, which test trading strategies on historical data. Inspect result files, strategy code, and configuration to identify bugs, make targeted repairs, rerun tests, and verify the updated metrics.

  • Investigating backtest execution errors
  • Finding why a strategy produces no trades
  • Checking delayed trades or low capital usage
HKUDS/Vibe-Trading36.3KUpdated Oct 22, 2026

See all skills by HKUDS

Report a problem with this skill