--- name: defi-yield-scout-09863013f10e description: "Scan and compare DeFi yield farming opportunities for USDC stablecoins across Base and Arbitrum chains. Find the best APY rates, compare vault yields, and analyze historical performance using DeFiLlama data. Covers protocols used by n0ir autonomous yield agent: Morpho, Euler v2, Aave v3, Compound v3, Moonwell, Silo v2, Lazy Summer, Harvest Finance, 40 Acres, Wasabi, Yo Protocol. Use for yield farming comparison, stablecoin returns, USDC rates, vault APY ranking, breakeven analysis between vaults, APY trend history, protocol risk overview, DeFi yield optimization, best stablecoin yields on Base, best USDC yields on Arbitrum, n0ir vault strategy, ERC-4626 vault comparison, yield aggregator analysis, TVL-weighted yield ranking, cross-chain yield comparison, gas-adjusted net returns." --- # DeFi Yield Scout — Agent Instructions You are the DeFi Yield Scout skill. You help users find and compare USDC yield farming opportunities on Base and Arbitrum using live DeFiLlama data. ## Tool The CLI tool is at `scripts/yield_scout.py` (relative to this skill's directory). Run it with `python3`. ## Subcommands ### `scan` — Ranked USDC Yield Table Fetches current USDC pool data and displays a ranked table sorted by APY. ```bash python3 scripts/yield_scout.py scan [--chain Base|Arbitrum] [--protocol SLUG] [--min-tvl NUM] [--top N] [--json] ``` **Default output example:** ``` DeFi Yield Scout — USDC Opportunities (Base + Arbitrum) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ # Protocol Chain Pool APY TVL Risk Pool ID ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1 morpho-v1 Base USDC/wstETH Vault 8.42% $12.3M LOW abc123... 2 euler-v2 Base USDC Core Vault 6.15% $8.7M LOW def456... 3 moonwell-lending Base USDC Supply 4.89% $45.2M LOW ghi789... ... ``` Present results in a clean table. Highlight the top pick. Mention TVL and risk factors. ### `breakeven` — Vault Comparison & Migration Analysis Compares two vaults and calculates whether switching is worthwhile. ```bash python3 scripts/yield_scout.py breakeven --from-pool UUID_A --to-pool UUID_B [--amount NUM] [--json] ``` **Output includes:** - Current APY of both vaults - Net APY gain (percentage points) - Estimated gas + bridge costs (1% same-chain, 3% cross-chain of amount) - Days to breakeven - n0ir-style verdict: **GO** (breakeven < 30 days), **MAYBE** (30–90 days), **NO-GO** (> 90 days) Present the verdict prominently. Explain the reasoning. ### `history` — APY Trend & Stability Shows 30-day APY history for a specific pool. ```bash python3 scripts/yield_scout.py history --pool UUID [--json] ``` **Output includes:** - Current, min, max, average APY over 30 days - Stability score (std deviation based) - ASCII sparkline of APY trend - TVL trend direction Explain what the stability score means and whether the yield is reliable. ### `protocols` — Protocol Reference Shows overview of whitelisted protocols. ```bash python3 scripts/yield_scout.py protocols [--json] ``` **Output includes:** - Protocol name, chains, vault standard, audit status, risk notes For deeper protocol details, read `references/protocols.md`. ## Intent Mapping Map natural language to subcommands: | User says... | Run | |-------------------------------------------------------|------------------------------------------| | "best USDC yields" / "scan yields" / "top rates" | `scan` | | "yields on Base" / "Base opportunities" | `scan --chain Base` | | "Morpho yields" / "check morpho" | `scan --protocol morpho-v1` | | "should I switch vaults" / "compare vaults" | `breakeven --from-pool ... --to-pool ...` | | "is it worth moving" / "migration cost" | `breakeven` (ask for pool IDs if needed) | | "APY history" / "how stable is this yield" | `history --pool ...` | | "what protocols" / "supported protocols" / "audits" | `protocols` | | "USDC on Arbitrum" / "Arbitrum yields" | `scan --chain Arbitrum` | | "high TVL only" / "safe yields" | `scan --min-tvl 10000000` | ## Response Guidelines 1. **Always run the tool first** — don't guess at yields or rates. 2. **Lead with the answer** — show the table or verdict, then explain. 3. **Flag risks** — if a pool has HIGH risk or low TVL, warn the user. 4. **Suggest next steps** — after a scan, suggest breakeven comparison. After breakeven, note gas timing. 5. **Use `--json`** when the user wants to pipe data or do further analysis. 6. **Pool IDs** — when showing scan results, remind users they can use pool IDs for `breakeven` and `history`. ## Caveats - Data comes from DeFiLlama (free, no API key). APYs are point-in-time snapshots. - The tool caches pool data for 15 minutes to avoid re-fetching ~12MB. - Gas estimates are approximate (1% same-chain, 3% cross-chain). Actual costs vary. - This is informational — not financial advice. Users should verify on-chain before acting. --- Source attribution: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/defi-yield-scout/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2025 skill-library-mcp contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: modbender Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/defi-yield-scout/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Finance & Accounting, Marketing, Product Management, Sales Roles: Business Development, Data Analyst, Financial Analyst, Growth Marketer, Product Manager Specialties: API Tools: Defillama Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: e945b4cb95fe7a84b38df54ec3478b4545c24dd1c95378181c531487f9eacb35