factor-research

Evaluate cross-sectional financial factors with IC/IR statistics and quantile backtests.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ebrahim-sani/trading-automation --skill factor-research-ebrahim-sani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: factor-research
Source: https://github.com/ebrahim-sani/trading-automation/tree/main/vibe-trading/agent/src/skills/factor-research
Command: npx skills add https://github.com/ebrahim-sani/trading-automation --skill factor-research-ebrahim-sani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically evaluates whether cross-sectional financial factors have genuine stock-selection power by computing information coefficients (IC), information ratios (IR), and performing quantile backtests to reveal predictive strength, stability, and potential biases.

Core Features & Use Cases

  • IC/IR Analysis: Compute daily IC series, summary statistics (mean, std, IR), and proportion of positive IC to judge factor direction and stability.
  • Quantile Backtesting: Produce group equity curves for quantile-sorted portfolios to assess monotonicity, long-short spread, and tail effects.
  • Factor Combination Methods: Support equal-weight, IC-weighted, and orthogonalized combinations for multi-factor construction and weight assignment.
  • Practical Uses: Single-factor validation (momentum, value, quality), factor decay and holding-period analysis, industry-neutral screening, and multi-factor portfolio construction.
  • Outputs & Requirements: Exports ic_series.csv, ic_summary.json, and group_equity.csv; requires aligned factor and forward-return CSVs (same dates and instrument columns).

Quick Start

Run the factor_analysis tool by supplying the factor CSV path, the aligned forward-return CSV path, and an output directory to generate IC series, IC summary, and quantile group equity curves.

Frequently Asked Questions about factor-research

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

FAQPage Schema
How do I evaluate cross-sectional factor predictive power using IC and quantile backtests?

To evaluate cross-sectional factor predictive power, compute information coefficients (IC), information ratios (IR), and quantile backtests using aligned factor and forward-return CSV datasets to reveal factor strength, stability, and biases.

What is factor decay analysis and how do I test it with holding periods?

Factor decay analysis measures how a factor's predictive power diminishes over time. You test it by applying IC/IR statistics and quantile backtests to aligned factor and forward-return CSVs across different holding periods.

How do I combine multiple financial factors using IC-weighted or orthogonalized methods?

You combine multiple financial factors using equal-weight, IC-weighted, or orthogonalized combination methods. This supports multi-factor portfolio construction by applying weight assignment to your validated cross-sectional factors.

Do I need aligned date and instrument axes for IC series and quantile backtesting?

Yes, you need aligned date and instrument axes for IC series and quantile backtesting. The process requires factor and forward-return CSVs with matching dates and instrument columns to accurately compute IC mean, std, and group equity curves.

What outputs do I get from running IC analysis and quantile backtests?

From running IC analysis and quantile backtests, you get ic_series.csv, ic_summary.json, and group_equity.csv. These exports contain IC series data, summary statistics, and quantile group equity curves for portfolio analysis.

Can I assess factor monotonicity and long-short spread using quantile-sorted portfolios?

Yes, you can assess factor monotonicity and long-short spread using quantile-sorted portfolios. Quantile backtesting produces group equity curves that reveal tail effects and predictive strength across different quantile groups.