When should I invoke this skill?

Invoke this skill when editing waterfall calculation files (tier or ledger), working on clawback behavior, or syncing waterfall documentation with code.

What is shortfall-based clawback in this context?

It is a partial clawback mechanism where GP carry is limited by fund-level profit above the LP shortfall. If LPs haven't achieved their capital and preferred return, the GP carry is reduced proportionally.

How does the Ledger engine differ from the Tier engine?

The Tier engine handles simple return-of-capital and carry splits without clawbacks. The Ledger engine manages a full history of contributions and distributions with complex, cumulative clawback rules.

How are truth-cases handled?

The skill manages truth-case JSON files which represent the 'source of truth' for distributions. It helps run targeted tests to compare expected vs. actual totals for LP distributions and GP carry.

Phoenix Waterfall Ledger Semantics

Name: Phoenix Waterfall Ledger Semantics
Author: nikhillinit

bynikhillinit

0•

分析与监控

Manages complex GP/LP waterfall distribution models and shortfall-based clawback logic for venture capital funds.

This skill provides specialized domain expertise for implementing and maintaining venture capital waterfall models, specifically focusing on the Phoenix VC fund structure. It handles both tier-based and ledger-based distribution engines, ensuring accurate calculation of General Partner (GP) carry and Limited Partner (LP) distributions. Its primary strength lies in managing shortfall-based partial clawback semantics, where GP carry is dynamically adjusted based on cumulative fund performance against LP capital and preferred returns, rather than simple time-based triggers. It is essential for developers working on financial analytics engines and fund accounting systems.

主要功能

01Synchronizes technical implementation with fund documentation and JSDoc

02Calculates shortfall-based partial clawbacks for GP carry

03Manages cumulative fund performance calculations for liquidation events

04Validates financial logic against standardized truth-case JSON scenarios

050 GitHub stars

06Implements tier-based and ledger-based distribution engines

使用场景

01Ensuring automated tests match expected truth-case distribution outcomes

02Updating waterfall logic to reflect new Limited Partnership Agreement (LPA) terms

03Debugging complex GP/LP distribution discrepancies in financial ledgers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nikhillinit/updog_restore phoenix-waterfall-ledger-semantics

For use in Claude.ai and ChatGPT

主要功能

01Synchronizes technical implementation with fund documentation and JSDoc

02Calculates shortfall-based partial clawbacks for GP carry

03Manages cumulative fund performance calculations for liquidation events

04Validates financial logic against standardized truth-case JSON scenarios

050 GitHub stars

06Implements tier-based and ledger-based distribution engines

使用场景

01Ensuring automated tests match expected truth-case distribution outcomes

02Updating waterfall logic to reflect new Limited Partnership Agreement (LPA) terms

03Debugging complex GP/LP distribution discrepancies in financial ledgers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nikhillinit/updog_restore phoenix-waterfall-ledger-semantics

For use in Claude.ai and ChatGPT