Agent skill

Factor Report

by minihellboy in minihellboy/factorminer

Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas).

MITAuto-check passedDocuments & Office

Install Factor Report

skills CLI
$ npx skills add minihellboy/factorminer --skill factor-report -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install minihellboy/factorminer factor-report --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/minihellboy/factorminer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/factor-researcher/plugin/skills/factor-report .claude/skills/factor-report && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
factor-report
GitHub stars
123
Token cost
~588 tokens
SKILL.md length
199 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas).

  • Works in 3 steps: Static report → Plots → Export the library
  • Package a finished research run for review
  • SKILL.md covers Workflow, Assembling the research note and Guardrails
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Factor Report is an agent skill from minihellboy/factorminer. Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas). Use to package a finished research run for review. Triggers on "generate report", "factor report", "research note", "tearsheet", "visualize factors", "export library", "write up the results".

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering CSV and tabular files. The repository describes itself as: A Self-Evolving Agent with Skills and Experience Memory for Financial Alpha Discovery. The licence is MIT.

When your agent uses it

  • Package a finished research run for review
  • Generate report
  • Visualize factors
  • Write up the results

Example prompts

  • “generate report”
  • “factor report”
  • “research note”
  • “/factor-report”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Static report
  2. Plots
  3. Export the library

What it can do on your machine

Read from SKILL.md and the folder at commit 75e0560. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Factor Report loads about 588 tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~588

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from minihellboy/factorminer at commit 75e0560, republished under its MIT licence (© minihellboy). 199 words, ~588 tokens.

Download SKILL.mdSave it as .claude/skills/factor-report/SKILL.md (or your agent's skills folder).
name
factor-report
description
Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas). Use to package a finished research run for review. Triggers on "generate report", "factor report", "research note", "tearsheet", "visualize factors", "export library", "write up the results".

Factor Report

This skill turns a finished run into reviewable artifacts: a static report, plots, and portable exports.

Workflow

1. Static report
bash
factorminer report output/run1/factor_library.json \
  --session-log output/run1/session_log.json \
  --format markdown --output output/run1/report.md
  • --format — markdown or html. HTML is self-contained (no JavaScript).
  • --session-log — includes run metadata (iterations, yield rate).
  • --benchmark path.json — fold in benchmark results; repeatable.

The report defines every admission metric inline, lists each factor with its formula and IC/ICIR/correlation, and warns on stale artifacts.

2. Plots
bash
factorminer -o output/run1 visualize output/run1/factor_library.json \
  --data market_data.csv --period test \
  --correlation --ic-timeseries --quintile --format png
3. Export the library
bash
factorminer export output/run1/factor_library.json --format formulas --output output/run1/formulas.txt

--format options: json (full library), csv (tabular metrics), formulas (plain formula list for handoff).

Assembling the research note

A complete note pairs the generated report with narrative the analyst can sign off on:

  1. Objective & data — universe, horizon, split boundaries, validation status.
  2. Method — loop used (Ralph/Helix), features enabled, iteration budget.
  3. Library — admitted factors with formulas and out-of-sample IC/ICIR.
  4. Composite — backtest result net of costs, with the decay caveat.
  5. Benchmark — comparison vs. baselines, if run.
  6. Limitations — overfit risk, capacity, what was not tested.

Guardrails

  • The report presents results; it does not certify them. Frame it as research staged for human review.
  • Quote out-of-sample metrics as the headline; never the in-sample number.
  • Cite the run directory so every figure is reproducible via factorminer session inspect.

© minihellboy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in integrations/factor-researcher/plugin/skills/factor-report of minihellboy/factorminer.

Open the folder on GitHubat commit 75e0560

Compare with similar skills

Factor Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Factor Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Factor Report this skillminihellboy/factorminer123—~588Automated safety check: PassMIT
Data Table Managern8n-io/n8n207k—~2.3kAutomated safety check: PassCustom licence
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Abuse Hunternexu-io/harness-engineering-guide663—~1.9kAutomated safety check: PassMIT
Markitshift-labs-ai/markit1.3k—~299Automated safety check: PassMIT
Sector Analysttradermonty/claude-trading-skills3k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Abuse Hunter

    nexu-io/harness-engineering-guide

    Detect and investigate bulk registration abuse on SaaS platforms.

    663 GitHub stars~1.9k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Sector Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing sector rotation patterns and market cycle positioning.

    3k GitHub starsUsed in 1 repo~2.3k tokens
    Documents & OfficeAuto-check passed
  • Uap Release Analyzer

    ckpxgfnksd-max/uap-release-analyzer

    Inventory, extract, and analyze tranches of declassified UAP/UFO files — including war.gov/UFO/ "PURSUE" releases, FBI Vault, NARA boxes, and AARO publications.

    155 GitHub stars~2.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed

More from minihellboy/factorminer

  • Factor Evaluation

    minihellboy/factorminer

    Evaluate a factor library — recompute Information Coefficient (IC), ICIR, win rate, and turnover on held-out data, and surface train→test decay.

    123 GitHub stars~605 tokensUpdated 10 days ago
    Auto-check passed
  • Factor Mining

    minihellboy/factorminer

    Discover alpha factors by running the FactorMiner research engine — the paper-faithful Ralph loop or the enhanced Helix loop (causal validation, regime conditioning, multi-specialist debate…

    123 GitHub stars~781 tokensUpdated 10 days ago
    Auto-check passed
  • Factor Backtest

    minihellboy/factorminer

    Combine a factor library into a composite signal and quintile-backtest it under transaction costs — long-short return, monotonicity, turnover, and tearsheets.

    123 GitHub stars~599 tokensUpdated 10 days ago
    Auto-check passed
  • Factor Benchmark

    minihellboy/factorminer

    Run FactorMiner benchmark workflows — the Table 1 Top-K freeze benchmark, memory and strategy ablations, transaction-cost pressure tests, and the full suite.

    123 GitHub stars~576 tokensUpdated 10 days ago
    Auto-check passed
  • Factor Data

    minihellboy/factorminer

    Validate, resample, and ingest market data for factor mining.

    123 GitHub stars~856 tokensUpdated 10 days ago
    Auto-check passed
  • Research Ingestion

    minihellboy/factorminer

    Absorb external research reports/papers into structured, retrievable hypothesis cues via FactorMiner's Report-to-Memory Absorption (RMA) service — an OHLCV-eligibility gate, a mechanism-family…

    123 GitHub stars~884 tokensUpdated 10 days ago
    Auto-check passed

Questions about Factor Report

What does Factor Report do?

Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas). Factor Report is an agent skill from minihellboy/factorminer. Generate static reports, tearsheets, and exports from FactorMiner artifacts — markdown/HTML research notes, plots, and library exports (JSON/CSV/formulas).

When should I use Factor Report?

Factor Report fits situations like: package a finished research run for review; generate report; visualize factors; write up the results.

How do I install Factor Report in Claude Code?

Run `npx skills add minihellboy/factorminer --skill factor-report -a claude-code`. Or copy the skill folder (integrations/factor-researcher/plugin/skills/factor-report in minihellboy/factorminer) into .claude/skills/factor-report in your project. Claude Code loads it when a task matches its description.

How do I install Factor Report in Codex?

Run `npx skills add minihellboy/factorminer --skill factor-report -a codex`. Or copy the skill folder (integrations/factor-researcher/plugin/skills/factor-report in minihellboy/factorminer) into .agents/skills/factor-report in your project. Codex loads it when a task matches its description.

Can I use Factor Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add minihellboy/factorminer --skill factor-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/factor-report, .gemini/skills/factor-report, .github/skills/factor-report and .opencode/skills/factor-report in your project.

What does Factor Report need to run?

SKILL.md names no scripts, command-line tools or credentials: Factor Report is instructions for the agent only.

Does Factor Report access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Factor Report safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Factor Report use?

Factor Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Factor Report use?

About 588 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Factor Report?

Skills that share tags, products or a category with Factor Report: Data Table Manager (n8n-io/n8n, 207k stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Abuse Hunter (nexu-io/harness-engineering-guide, 663 stars) and Markit (shift-labs-ai/markit, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Factor Report?

minihellboy (a GitHub user) maintains it in minihellboy/factorminer, which has 123 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 28, 2026.

Source: minihellboy/factorminer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.