name: pnl description: Calculate and display P&L metrics and attribution argument-hint: "[--today|--mtd|--ytd|--attribution]"

P&L Calculator

Calculate and display profit & loss metrics with attribution.

Usage

• /pnl - Today's P&L summary
• /pnl --mtd - Month-to-date P&L
• /pnl --ytd - Year-to-date P&L
• /pnl --attribution - P&L attribution analysis
• /pnl --by-strategy - P&L by strategy
• /pnl --by-symbol AAPL - P&L for specific symbol
• /pnl --realized - Only realized P&L

P&L Components

| Component | Description | |-----------|-------------| | Realized | Closed position P&L | | Unrealized | Open position mark-to-market | | Fees | Trading fees and commissions | | Financing | Margin interest, borrowing costs | | FX | Currency conversion impact |

Instructions

When this skill is invoked:

1. Parse arguments:

   • No args: Today's P&L
   • --mtd: Month-to-date
   • --ytd: Year-to-date
   • --days N: Last N days
   • --attribution: Detailed attribution
   • --by-strategy: Group by strategy
   • --by-symbol: Filter to symbol
   • --realized: Only closed P&L

2. Fetch P&L data:

   • API endpoint: GET /pnl
   • With period: ?period=mtd

3. Display P&L summary:

   ═══════════════════════════════════════════════════════════
                     P&L SUMMARY - TODAY
   ═══════════════════════════════════════════════════════════
   
   Gross P&L:          +$4,250.00
   Fees & Commissions:    -$125.50
   Financing:              -$45.00
   ─────────────────────────────────────────────────────────
   Net P&L:            +$4,079.50  (+0.33%)
   
   BREAKDOWN
   ─────────────────────────────────────────────────────────
   Realized:           +$2,150.00
   Unrealized:         +$1,929.50
   
   BY STRATEGY
   ─────────────────────────────────────────────────────────
   Momentum:           +$2,500.00  ████████████
   Mean Reversion:       +$800.00  ████
   Stat Arb:             +$779.50  ███
   

4. For --attribution:

   • Asset allocation: Contribution by asset class
   • Security selection: Alpha from stock picking
   • Timing: Contribution from entry/exit timing
   • Factor exposure: Factor-based attribution
   • Residual: Unexplained P&L

5. Display top winners/losers:

   TOP WINNERS                    TOP LOSERS
   ─────────────────────────────────────────────
   NVDA    +$1,250 (+2.1%)       TSLA    -$450 (-1.2%)
   AAPL      +$890 (+1.5%)       META    -$320 (-0.8%)
   GOOGL     +$650 (+1.2%)       AMZN    -$180 (-0.4%)
   

6. Show P&L chart (ASCII):

   Cumulative P&L (MTD)
        │
   $15K ┤                              ╭─
   $10K ┤                    ╭────────╯
    $5K ┤          ╭────────╯
     $0 ┼────╮    ╯
   -$5K ┤    ╰───╯
        └────────────────────────────────
        1    5    10   15   20   25   30
   

7. Summary metrics:

   • Win rate (% of profitable days)
   • Average win vs average loss
   • Profit factor (gross wins / gross losses)
   • Best/worst day