research-pdf

Generates professional PDF research reports from structured research specifications using Typst templates.

Updated Jun 27, 2026
One-click install
npx skills add https://github.com/HKUST-QUANT-SOCIETY/quantcode --skill research-pdf-hkust-quant-society
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-pdf
Source: https://github.com/HKUST-QUANT-SOCIETY/quantcode/tree/main/.opencode/groups/fundamental/skills/research-pdf
Command: npx skills add https://github.com/HKUST-QUANT-SOCIETY/quantcode --skill research-pdf-hkust-quant-society

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing equity research reports manually is slow and inconsistent in formatting. This Skill turns a structured research specification (company, date, focus areas) into a publishable PDF report styled after CICC/Huatai research formats, with citations pulled from source documents. ## Core Features & Use Cases - Structured Input: Accepts a ResearchSpec conforming to schemas/research-spec.schema.json defining company, time point, and focus areas. - RAG-Grounded Content: Calls the pit-rag skill to retrieve relevant research reports, financial statements, and announcements before generating sections (overview, business, financials, valuation, risks). - Typst PDF Rendering: Fills templates/typst/research-report.typ and compiles it with typst compile, outputting to artifacts/research/<company>-<date>.pdf. - Use Case: An analyst provides a spec for company 2097HK as of 2026-06-27; the Skill retrieves source materials, drafts DCF and relative valuation sections with 10+ citations, and renders a formatted PDF for in-task review. ## Quick Start Provide a research specification for a company and date, then ask the agent to generate the styled PDF research report with cited sections and valuation analysis.

Frequently Asked Questions about research-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a PDF equity research report from a structured spec?

Provide a ResearchSpec matching schemas/research-spec.schema.json with the company, time point, and focus areas. The workflow retrieves source documents, generates each section, fills the Typst template, and compiles the PDF into artifacts/research/.

What tool renders the research report PDF?

The report is rendered with Typst. The Skill fills templates/typst/research-report.typ with generated section content and runs typst compile, which must exit with code 0 for the report to pass acceptance.

What sections does the generated research report include?

The report includes company overview, business analysis, financial analysis, valuation (DCF and relative valuation), and risk disclosures. All sections must be non-empty and the report must contain at least ten citations.

Does the report generation use retrieved source documents?

Yes. The workflow first calls the pit-rag skill to pull relevant research reports, financial statements, and announcements. Generated sections are grounded in these retrieved materials, and citation counts are reported in the output.

Can a generated report be published directly after rendering?

No. A researcher must review the content within the task first. Publishing or sharing requires a separate precise merge approval; content approval inside the task does not authorize broad distribution.