performance-attribution

Perform Brinson-style attribution and factor decomposition of portfolio returns against a benchmark.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/Liangwei-zhang/six-stock --skill performance-attribution-liangwei-zhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-attribution
Source: https://github.com/Liangwei-zhang/six-stock/tree/main/Vibe-Trading/agent/src/skills/performance-attribution
Command: npx skills add https://github.com/Liangwei-zhang/six-stock --skill performance-attribution-liangwei-zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool provides rigorous performance attribution to explain why a portfolio outperformed or underperformed its benchmark, covering Brinson sector/stock attribution, factor alpha/beta decomposition, and market-timing evaluation.

Core Features & Use Cases

  • Brinson attribution for single- and multi-period decomposition, including allocation, selection, and interaction effects against a benchmark.
  • Factor attribution to quantify alpha, beta, and factor exposures using standard models (e.g., Fama-French), with practical interpretation.
  • Benchmarking & timing to assess market-timing practices and compare performance to relevant benchmarks; supports scenario analysis and rolling metrics.

Quick Start

Provide the portfolio and benchmark returns and run the attribution to generate sector, stock-selection, and factor contributions.

Frequently Asked Questions about performance-attribution

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

FAQPage Schema
How do I perform Brinson attribution to decompose portfolio excess returns?

Brinson attribution decomposes excess portfolio returns into allocation, selection, and interaction effects against a benchmark. You provide portfolio and benchmark returns with weights to generate a structured breakdown of sector and stock-level performance drivers.

What is factor attribution and how does it quantify portfolio alpha and beta?

Factor attribution quantifies alpha, beta, and factor exposures using standard models like Fama-French to evaluate performance. It requires portfolio returns and factor metrics to produce a structured breakdown of how specific risk factors drove excess returns.

How do I assess market timing practices against a benchmark?

Market timing assessment evaluates timing practices by applying timing indicators against benchmark data. This process produces structured timing assessments to determine whether portfolio allocation shifts successfully added value relative to the benchmark.

Can I run multi-period attribution to evaluate rolling portfolio metrics?

Multi-period attribution supports scenario analysis and rolling metrics to evaluate portfolio performance across multiple timeframes. By linking single-period attribution results over time, it produces a continuous breakdown of sector and stock-selection contributions.

What data do I need to calculate portfolio attribution and factor exposures?

Calculating portfolio attribution requires data on portfolio and benchmark returns, weights, factor metrics, and timing indicators. Providing these inputs allows the attribution process to generate sector, stock-selection, and factor contribution breakdowns.