n0ir DeFi Yield Scout

Scan and compare USDC yield farming options on Base and Arbitrum with APY rankings, breakeven analysis, historical trends, and protocol risk summaries.

Security Scan

The skill's code, instructions, and requested resources are coherent with its stated purpose (scanning USDC yield opportunities using DeFiLlama); it requires no credentials and has no unusual install steps.

Purpose & Capability

Name/description match the implementation: the Python CLI fetches pool and chart data from DeFiLlama, filters to the listed whitelisted protocols and L2 chains, and implements scan/breakeven/history/protocols subcommands described in SKILL.md.

Instruction Scope

SKILL.md directs the agent to run the included Python script and to use DeFiLlama as the data source. The runtime instructions do not ask the agent to read unrelated files or environment variables. The script only reads/writes a cache file in the system temp directory and calls the DeFiLlama endpoints declared in the code.

Install Mechanism

No install spec is provided (instruction-only with bundled script). The code uses only Python stdlib and performs a harmless cache write to the system temp directory; there are no downloads from untrusted URLs or package installs.

Credentials

The skill requests no environment variables, no credentials, and only queries public DeFiLlama endpoints. No secret or unrelated service access is required.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide configuration. It persists only a temporary cache file (yield_scout_pools.json) in the OS temp directory.

Assessment

This skill appears to do what it says: it queries DeFiLlama, filters to a small whitelist of protocols, and presents scan/breakeven/history analyses. Before installing, consider: (1) the source and homepage are unknown — verify you trust the publisher and review the included Python file yourself; (2) the skill fetches live data from yields.llama.fi and writes a cache file in your temp directory (not sensitive, but note it persists data for 15 minutes); and (3) this is informational only — always verify on-chain before moving funds. No credentials are requested, and there are no downloads or unusual privileges.

n0ir DeFi Yield Scout — Agent Instructions

You are the n0ir DeFi Yield Scout skill, built by n0ir Labs (https://n0ir.ai). You help users find and compare USDC yield farming opportunities on Base and Arbitrum using the same protocol set as n0ir's autonomous yield agent, powered by 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.

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.

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.

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.

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.