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.