Rank If — Counterfactual Rank Simulator
rank_ifAnswers 'What would it take to reach a target rank?' — takes your current 4 token pillars and a target percentile (e.g. 90 for top 10%), then simulates the smallest metric changes needed to reach that position. Returns: current rank/percentile, simulated rank/percentile, the specific pillar changes required, and the yield delta. This turns SigRank from a scoreboard into a simulator. Use it when someone asks 'what would move my rank?' or 'how do I get to top 10%?'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Current input tokens. | |
| output | Yes | Current output tokens. | |
| window | No | Time window for field comparison (default 30d). | 30d |
| cache_read | Yes | Current cache-read tokens. | |
| cache_write | Yes | Current cache-write tokens. | |
| target_percentile | Yes | Target percentile (0-100). E.g. 90 for top 10%, 99 for top 1%. |