report_evaluation

Recompute ground-truth metrics from offline DuckDB data for weekly report evaluations.

11|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/xueqingpeng/trading-analysis --skill report-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report_evaluation
Source: https://github.com/xueqingpeng/trading-analysis/tree/main/.claude/skills/report_evaluation
Command: npx skills add https://github.com/xueqingpeng/trading-analysis --skill report-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Evaluates a report_generation run for one ticker / model combination by reading generated WEEKLY Markdown reports and offline DuckDB market data, then scores the run across five dimensions and aggregates run-level backtest metrics. Writes one JSON result plus one structured Markdown summary to results/report_evaluation/.

Core Features & Use Cases

  • Recomputes ground-truth metrics for weekly reports using the generation's MCP logic to ensure alignment with produced outputs.
  • Performs per-report scoring and run-level backtests across ticker/model combinations using offline data and the MCP tooling.
  • Produces a machine-readable JSON artifact plus a human-readable Markdown summary for auditing and comparison.

Quick Start

Run a completed evaluation against a set of generated reports and persist the results with upsert_evaluation to produce JSON and Markdown artifacts.

Frequently Asked Questions about report_evaluation

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

FAQPage Schema
How do I evaluate generated weekly reports against ground-truth market data?

To evaluate weekly reports against ground-truth data, recompute metrics offline using DuckDB and MCP tools, then output a JSON payload and Markdown summary via upsert_evaluation.py for per-report scoring and backtesting.

Can I backtest ticker and model combinations offline without internet access?

Yes, you can backtest ticker and model combinations offline. The process reads offline DuckDB market data and generated Markdown reports to perform run-level backtesting without requiring internet access.

How does automated report scoring work with DuckDB and MCP?

Automated report scoring works by recomputing ground-truth metrics from offline DuckDB data using the generation's MCP logic. It scores runs across five dimensions and aggregates results into JSON and Markdown artifacts.

What do I need to run an automated evaluation on generated Markdown reports?

You need the report_evaluation MCP server, access to a DuckDB database, and the generated Markdown report artifacts to execute the evaluation and produce scoring results.

What are the limitations of using offline DuckDB data for report backtesting?

The limitation of using offline DuckDB data for backtesting is that no internet access is permitted during evaluation. The process strictly relies on pre-existing offline data and generated report artifacts to compute ground-truth metrics.

Does report_evaluation produce machine-readable outputs for auditing?

Yes, report_evaluation produces a machine-readable JSON artifact alongside a human-readable structured Markdown summary. Both are written to the results directory for auditing and comparison purposes.