report_generation

Generate a structured weekly equity research report for one symbol using MCP tools.

Updated May 3, 2026
One-click install
npx skills add https://github.com/CYP0630/agentic_benchmark_single_agent --skill report-generation-cyp0630
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report_generation
Source: https://github.com/CYP0630/agentic_benchmark_single_agent/tree/main/skills/report_generation
Command: npx skills add https://github.com/CYP0630/agentic_benchmark_single_agent --skill report-generation-cyp0630

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires duckdb, numpy, pandas, pandas_ta, fastmcp, pydantic, and includes scripts (resource) components.

What problem does it solve?

Analysts spend significant time compiling and standardizing weekly equity research notes; this skill automates the creation of a standalone weekly report for one symbol and a target week ending date, ensuring consistent structure and provenance of data.

Core Features & Use Cases

  • Reads offline data via the report_generation_mcp server to assemble a complete weekly report, including a Markdown document and a run-level summary JSON
  • Returns the mandated 16 metrics (alpha, momentum, beta) plus context fields, sourced from get_weekly_metrics, list_news, list_filings, list_peers
  • Enforces no external API calls and builds output through upsert_report.py for persistence
  • Typical use case: generate a weekly investor letter for AAPL for week ending 2026-01-02 and store it for review

Quick Start

Provide the SYMBOL and TARGET_DATE to generate a weekly report.

Frequently Asked Questions about report_generation

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

FAQPage Schema
How do I automate weekly equity research report generation?

You can automate weekly equity research report generation by providing a stock symbol and target week ending date. The system uses MCP tools to read offline data via DuckDB, assembling 16 structured metrics and context fields into a standardized Markdown document and summary JSON without external API calls.

What metrics are included in an automated equity weekly report?

An automated equity weekly report includes 16 mandated metrics such as alpha, momentum, and beta, alongside context fields. These metrics are sourced from offline data using get_weekly_metrics, list_news, list_filings, and list_peers to ensure consistent structure and data provenance for financial analysis.

Does the report generation workflow allow external API calls for real-time data?

The report generation workflow strictly enforces no external API calls, relying entirely on offline data via the report_generation_mcp server. It uses list_news, list_filings, and get_filing_section to gather context, ensuring all results are produced through upsert_report.py without ad-hoc data execution.

Can I use DuckDB with pandas to generate financial analysis reports?

Yes, you can use DuckDB with pandas to generate financial analysis reports by reading offline data through MCP tools. This combination supports the extraction of 16 weekly metrics and peer context, building structured output via upsert_report.py for persistent storage and review.

How do I persist a generated weekly research report for review?

To persist a generated weekly research report, all results must be produced via upsert_report.py. This script handles the storage of the complete weekly report, including the Markdown document and run-level summary JSON, ensuring the output is saved for subsequent review.

What are the limitations of using offline MCP tools for equity research?

The limitation of using offline MCP tools for equity research is the strict enforcement of no external API calls, meaning all data must pre-exist locally. Additionally, no ad-hoc data or code should be executed outside the mandated MCP workflow using upsert_report.py.