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.