pnl

Retrieve per-risk-factor PnL breakdowns for a numeric node_id on a specified date.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill pnl-specforgeai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pnl
Source: https://github.com/SpecForgeAI/deepagent-bot/tree/main/skills/pnl
Command: npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill pnl-specforgeai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing profits and losses by risk factor for a specific business node is labor-intensive and error-prone. This skill decomposes PnL by risk factors (FX, IR, EQ, etc.), enabling precise attribution and faster decision-making.

Core Features & Use Cases

  • Risk-factor PnL breakdown: Retrieve daily, monthly-to-date (MTD), and year-to-date (YTD) PnL by risk factor for a given node.
  • Input validation & contracts: Enforces numeric node_id only and guides users to resolve text inputs via node_resolver.
  • Structured outputs for downstream workflows: Returns a JSON payload with per-factor PnL, totals, and metadata ready for dashboards or reports.

Quick Start

Ask the system to retrieve the PnL by risk factors for a numeric node_id on a specific date.

Frequently Asked Questions about pnl

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

FAQPage Schema
How do I get PnL breakdown by risk factor for a specific business node?

You retrieve a PnL breakdown by risk factor by providing a numeric node_id and a valid date. The system returns a structured JSON payload with per-risk-factor PnL, totals, and metadata ready for dashboards.

What is risk factor PnL attribution and when do I need it?

Risk factor PnL attribution decomposes profits and losses by underlying factors like FX, IR, and EQ. You need it when precise attribution across business nodes is required for faster, data-driven decision-making.

How do I resolve a node name to a node_id for PnL analysis?

If your input includes a non-numeric node name, you must invoke a node_resolver to obtain the corresponding numeric node_id. Once resolved, retry the PnL request using the numeric identifier.

What date formats are valid for requesting daily, MTD, or YTD PnL?

Valid date inputs for PnL requests are strictly yesterday, today, or a valid ISO date. Submitting an unrecognized date format will trigger an INVALID_DATE error and prevent the breakdown.

Why am I getting a MISSING_NODE_ID error during PnL attribution?

A MISSING_NODE_ID error occurs when the input lacks a numeric node_id. You must provide a valid numeric identifier or resolve a text-based node name to a numeric ID before requesting the PnL breakdown.

Can I use text-based node names instead of numeric IDs for risk analysis?

You cannot directly use text-based node names for risk analysis; the system enforces numeric node_id inputs only. You must first resolve any text names to a numeric ID using a node_resolver component.