Agent skill

Pnl Explain

by YicunAI in YicunAI/Pnlclaw-community

Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns

AGPL-3.0Auto-check passedBusiness, Finance & HR

Install Pnl Explain

skills CLI
$ npx skills add YicunAI/Pnlclaw-community --skill pnl-explain -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install YicunAI/Pnlclaw-community pnl-explain --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/YicunAI/Pnlclaw-community.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pnl-explain .claude/skills/pnl-explain && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pnl-explain
GitHub stars
197
Token cost
~339 tokens
SKILL.md length
143 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns

  • Works in 4 steps: Obtain the paper account_id (and… → Call paper_pnl for aggregate and… → Call explain_pnl for realized vs… → …
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Description, Triggers, Steps and Tools Used, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pnl Explain is an agent skill from YicunAI/Pnlclaw-community. Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns

Its SKILL.md is about 340 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Trading and backtesting. The repository describes itself as: PnLClaw — local-first crypto and prediction market quant engine. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Trading and backtesting

Example prompts

  • “Use the pnl-explain skill to explain profit and loss composition and attribution for paper accounts using engine-calculated breakdowns”
  • “/pnl-explain”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Obtain the paper account_id (and optional symbol filter).
  2. Call paper_pnl for aggregate and per-symbol PnL figures where available.
  3. Call explain_pnl for realized vs unrealized decomposition and narrative detail.
  4. Tie changes to positions, fees, and marks—clearly labeling estimates when prices are stale.

What it can do on your machine

Read from SKILL.md and the folder at commit 933014f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pnl Explain loads about 339 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 143 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~339

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from YicunAI/Pnlclaw-community at commit 933014f, republished under its AGPL-3.0 licence (© YicunAI). 143 words, ~339 tokens.

Download SKILL.mdSave it as .claude/skills/pnl-explain/SKILL.md (or your agent's skills folder).
name
pnl-explain
description
Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns
version
0.1.0
tags
pnl, explanation, paper-trading
user_invocable
true
model_invocable
true
requires_tools
explain_pnl, paper_pnl

PnL Explanation

Description

Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns.

Triggers

  • "Why is my PnL down this week?"
  • "Break down my paper account PnL"

Steps

  1. Obtain the paper account_id (and optional symbol filter).
  2. Call paper_pnl for aggregate and per-symbol PnL figures where available.
  3. Call explain_pnl for realized vs unrealized decomposition and narrative detail.
  4. Tie changes to positions, fees, and marks—clearly labeling estimates when prices are stale.

Tools Used

  • explain_pnl: Decompose realized and unrealized PnL with per-position context.
  • paper_pnl: Query paper account-level PnL summaries for quick numeric grounding.

Example Interaction

User: Explain my PnL on account paper-123. Agent: I will call paper_pnl for the headline numbers, then explain_pnl with account_id paper-123 to break down realized vs unrealized drivers.

Notes

  • Attribution is based on simulated/paper state; live trading may differ due to fills and fees.

© YicunAI, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/pnl-explain of YicunAI/Pnlclaw-community.

Open the folder on GitHubat commit 933014f

Compare with similar skills

Pnl Explain next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pnl Explain compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pnl Explain this skillYicunAI/Pnlclaw-community197—~339Automated safety check: PassAGPL-3.0
Tushare Datazillionare/zillionare3212 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle875—~5.9kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3591 repos~2kAutomated safety check: PassApache-2.0
Markdownfacioquo/stock-indicators-dotnet1.2k—~812Automated safety check: PassApache-2.0

Similar skills

  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    321 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    875 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    359 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Markdown

    facioquo/stock-indicators-dotnet

    Format and lint Markdown in this repository against GitHub Flavored Markdown and its markdownlint-cli2 configuration — headers, lists, code fences, callouts (VitePress containers on docs-site pages…

    1.2k GitHub stars~812 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Openmobius Skill

    MobiusQuant/OpenMobius-skill

    Provides multi-school trading Q&A, chart/OHLCV analysis, annotation, and fresh-market workflows covering ICT/SMC, ChanLun, Wyckoff, Price Action, Order Flow, VSA, and Elliott Wave.

    695 GitHub stars~7.2k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from YicunAI/Pnlclaw-community

All 8 skills in this repo
  • Strategy Coder

    YicunAI/Pnlclaw-community

    Generate valid EngineStrategyConfig YAML for PnLClaw strategies

    197 GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Backtest Explain

    YicunAI/Pnlclaw-community

    Analyzes backtest results in plain language, connecting metrics to what they mean for the strategy

    197 GitHub stars~378 tokensUpdated 6 mo ago
    Auto-check passed
  • Exchange Setup

    YicunAI/Pnlclaw-community

    Guides the user through exchange connectivity and configuration safely, without handling secrets in chat

    197 GitHub stars~394 tokensUpdated 6 mo ago
    Auto-check passed
  • Indicator Guide

    YicunAI/Pnlclaw-community

    Explains common technical indicators (SMA, EMA, RSI, MACD) with quantitative intuition and example calculations

    197 GitHub stars~389 tokensUpdated 6 mo ago
    Auto-check passed
  • Market Analysis

    YicunAI/Pnlclaw-community

    Analyzes current market state and short-term trends using ticker, candle, and narrative context

    197 GitHub stars~364 tokensUpdated 6 mo ago
    Auto-check passed
  • Risk Report

    YicunAI/Pnlclaw-community

    Generates a risk assessment for current or hypothetical positions using engine rules and paper state

    197 GitHub stars~375 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Pnl Explain

What does Pnl Explain do?

Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns. Pnl Explain is an agent skill from YicunAI/Pnlclaw-community.

When should I use Pnl Explain?

Pnl Explain fits situations like: tasks that involve Trading and backtesting.

How do I install Pnl Explain in Claude Code?

Run `npx skills add YicunAI/Pnlclaw-community --skill pnl-explain -a claude-code`. Or copy the skill folder (skills/pnl-explain in YicunAI/Pnlclaw-community) into .claude/skills/pnl-explain in your project. Claude Code loads it when a task matches its description.

How do I install Pnl Explain in Codex?

Run `npx skills add YicunAI/Pnlclaw-community --skill pnl-explain -a codex`. Or copy the skill folder (skills/pnl-explain in YicunAI/Pnlclaw-community) into .agents/skills/pnl-explain in your project. Codex loads it when a task matches its description.

Can I use Pnl Explain in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add YicunAI/Pnlclaw-community --skill pnl-explain -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pnl-explain, .gemini/skills/pnl-explain, .github/skills/pnl-explain and .opencode/skills/pnl-explain in your project.

What does Pnl Explain need to run?

SKILL.md names no scripts, command-line tools or credentials: Pnl Explain is instructions for the agent only.

Does Pnl Explain access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pnl Explain safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pnl Explain use?

Pnl Explain is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pnl Explain use?

About 339 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pnl Explain?

Skills that share tags, products or a category with Pnl Explain: Tushare Data (zillionare/zillionare, 321 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars), Digital Oracle (komako-workshop/digital-oracle, 875 stars) and Polyclaw (chainstacklabs/polyclaw, 359 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pnl Explain?

YicunAI (a GitHub user) maintains it in YicunAI/Pnlclaw-community, which has 197 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on April 8, 2026.

Source: YicunAI/Pnlclaw-community on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.