Skip to main content
skill CX Codex

optimizing-staking-rewards — Claude Code skill: setup and usage

optimizing-staking-rewards compares staking yields across PoS networks and liquid protocols with risk evaluations. Helps identify competitive rates and rebalance positions.

MIT 1 installs ★ 2,935 updated 2026-11-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill optimizing-staking-rewards -a claude-code
Open on GitHub

What optimizing-staking-rewards does

This skill evaluates asset allocation across Proof-of-Stake networks and liquid staking platforms. Driven by the staking_optimizer.py script, it queries DeFiLlama public endpoints to calculate net returns after validator fees, assessing locked capital and unbonding delays.

It also calculates transition trade-offs when shifting capital between pools, factoring in transaction fees alongside projected yield differences. Running this workflow requires Python with the requests package, and queries fail if outbound access to DeFiLlama endpoints is blocked.

What it helps with

  • compare net staking returns across liquid protocols
  • assess smart contract risks and unbonding delays
  • calculate transaction costs when migrating positions
  • export yield comparison tables to JSON or CSV

Example prompts for the agent

  • Compare native and liquid staking yields for ETH
  • Optimize my current staking positions and account for gas costs
  • Export protocol yield comparison data to JSON

How to install optimizing-staking-rewards

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill optimizing-staking-rewards -a claude-code

2Manually: put the files in place

~/.claude/skills/optimizing-staking-rewards/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/optimizing-staking-rewards/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about optimizing-staking-rewards

How do I install optimizing-staking-rewards in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill optimizing-staking-rewards -a claude-code.

What does optimizing-staking-rewards do?

It aggregates staking metrics across protocols, determines net yields after platform cuts, and scores protocol risks.

What dependencies are needed to run the optimizer?

You need Python with the requests library installed, plus network connectivity to DeFiLlama APIs.

Source text

SKILL.md · MIT
---
name: optimizing-staking-rewards
description: 'Compare and optimize staking rewards across validators, protocols, and
  blockchains with risk assessment.

  Use when analyzing staking opportunities, comparing validators, calculating staking
  rewards, or optimizing PoS yields.

  Trigger with phrases like "optimize staking", "compare staking", "best staking APY",
  "liquid staking", "validator comparison", "staking rewards", or "ETH staking options".

  '
allowed-tools: Read, Write, Edit, Grep, Glob, Bash(crypto:staking-*)
version: 1.27.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- crypto
- optimizing-staking
compatibility: Designed for Claude Code
---
# Optimizing Staking Rewards

## Overview

Analyze staking opportunities across PoS blockchains and liquid staking protocols. Compares APY/APR, calculates net yields after fees, assesses protocol risks, and recommends optimal allocations.

## Prerequisites

1. **Python 3.8+** installed
2. **Dependencies**: `pip install requests`
3. Network access to DeFiLlama APIs
4. Optional: CoinGecko API key for higher rate limits

## Instructions

1. **Compare staking options** for a specific asset:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH
   ```

   Shows protocol name, type (native vs liquid), gross/net APY, risk score, TVL, and lock-up period.

2. **Analyze with position size** for gas-adjusted yields:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH --amount 10
   ```

   Calculates effective APY accounting for gas costs and projects returns at 1M, 3M, 6M, and 1Y.

3. **Optimize existing portfolio** with current positions:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --optimize \
     --positions "10 ETH @ lido 4.0%, 100 ATOM @ native 18%, 50 DOT @ native 14%"
   ```

   Suggests higher-yield alternatives with projected improvement and switching costs.

4. **Compare protocols or run risk assessment**:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --compare --protocols lido,rocket-pool,frax-ether
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH --detailed
   ```

5. **Export results** in JSON or CSV:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH --format json --output staking.json
   ```

## Output

Comparison table ranked by risk-adjusted return (Net APY multiplied by Risk Score / 10), showing native and liquid staking options:

```
  STAKING OPTIONS FOR ETH                              2025-01-15 15:30 UTC  # 2025 timestamp
  Protocol        Type      Gross APY  Net APY  Risk   TVL         Unbond
  Frax (sfrxETH)  liquid      5.10%     4.59%   7/10   $450M       instant
  Lido (stETH)    liquid      4.00%     3.60%   9/10   $15B        instant
  Rocket Pool     liquid      4.20%     3.61%   8/10   $3B         instant
  Coinbase cbETH  liquid      3.80%     3.42%   9/10   $2B         instant
  ETH Native      native      4.00%     4.00%   10/10  $50B        variable
```

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| API timeout | DeFiLlama unreachable | Cached data used with warning |
| Invalid asset | Unknown staking asset | Lists supported assets |
| Rate limited | Too many API calls | Automatic retry with backoff |
| No data found | Protocol not indexed | Falls back to known protocol list |

See [`references/errors.md`](references/errors.md) for comprehensive error handling.

## Examples

Common staking analysis workflows from single-asset comparison to full portfolio optimization:

```bash
# Quick ETH staking comparison
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH

# Large position with full risk analysis
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH --amount 100 --detailed

# Multi-asset comparison exported to CSV
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --assets ETH,SOL,ATOM --format csv

# Portfolio optimization with current positions
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --optimize \
  --positions "50 ETH @ lido 3.6%, 500 SOL @ marinade 7.5%"  # 500 - minimum stake amount in tokens
```

## Resources

- [`references/implementation.md`](references/implementation.md) - Optimization reports, risk assessment details, disclaimers
- [`references/errors.md`](references/errors.md) - Comprehensive error handling
- DeFiLlama Yields: https://defillama.com/yields
- StakingRewards: https://www.stakingrewards.com
- Lido: https://lido.fi | Rocket Pool: https://rocketpool.net

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for Finance and business →

From the same set139

The whole set →
windsurf-license-management windsurf-license-management keeps track of Windsurf seats: builds a license inventory, sets who gets a seat, and turns usage into cost and audit reports. CX Codex +1 1installs windsurf-cost-tuning windsurf-cost-tuning audits Devin Desktop (formerly Windsurf) subscriptions by analyzing seat types, quota consumption, and extra on-demand usage limits. CX Codex +1 1installs lokalise-cost-tuning lokalise-cost-tuning audits Lokalise usage, contributor seats, translation workflows, and unused keys when you need to review or reduce localization costs. CX Codex +1 1installs optimizing-defi-yields optimizing-defi-yields — a skill for finding and comparing yields across DeFi protocols with APY/APR calculations, risk assessment, and optimization guidance. CX Codex +1 1installs tracking-crypto-derivatives tracking-crypto-derivatives collects public exchange data on crypto derivatives, including funding, open interest, futures basis, liquidations and options. Use it to compare markets by symbol. CX Codex +1 1installs tracking-crypto-portfolio tracking-crypto-portfolio — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that monitors crypto holdings with live valuations, asset allocation analysis, and P&L tracking. CX Codex +1 1installs calculating-crypto-taxes calculating-crypto-taxes is a Claude Code skill that processes exchange CSVs, calculates crypto capital gains using FIFO, LIFO, or HIFO, and prepares Form 8949 data. CX Codex +1 1installs finding-arbitrage-opportunities finding-arbitrage-opportunities compares top bid and ask prices for a crypto pair across exchanges, applies taker fees, and searches triangular cycles. Useful for checking price gaps. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open