name	venus-protocol-ops
description	Analyze Venus Protocol lending/borrowing positions on BNB Chain with risk-first guidance. Use when users ask about Venus markets, collateral/borrow decisions, health factor, liquidation risk, APY/utilization comparison, isolated pools, or "can I borrow X safely" style what-if checks.

Venus Protocol Ops

Overview

Use this skill to provide read-only, risk-aware analysis for Venus Protocol. Prioritize liquidation safety, clarity, and explicit uncertainty over aggressive yield-chasing.

Workflow

1) Classify user intent

Map request into one of these modes:

Market scan: compare assets/pools (supply APY, borrow APY, utilization, caps)
Position check: assess a wallet's current collateral/borrow health
What-if simulation: estimate risk after a proposed borrow/supply/repay
Execution planning: prepare step-by-step actions without broadcasting tx

If user asks for onchain execution, pause and request explicit confirmation + exact parameters. Use simulation first, then broadcast only after user confirms.

2) Collect data

Use scripts first:

scripts/fetch_markets.py for market snapshot (official API base: https://api.venus.io, default scope: Core Pool only via references/pool-filter.json)
scripts/wallet_onchain_exposure.py for real wallet onchain exposure
scripts/check_wallet_exposure.py for manual/API fallback wallet summary
scripts/simulate_borrow.py for hypothetical borrow impact
scripts/venus_deposit.js for deposit preview/broadcast flow (approve + mint)
scripts/venus_withdraw.js for withdraw preview/broadcast flow (redeem / redeemUnderlying) with post-withdraw HF prediction and safety line checks (default 1.2, user customizable)
scripts/venus_borrow.js for borrow preview/broadcast flow
scripts/venus_repay.js for repay preview/broadcast flow (approve + repayBorrow)
scripts/venus_collateral.js for collateral enable/disable (enterMarkets / exitMarket)
scripts/hf_monitor.py for threshold-based HF monitoring and advisory actions (includes ACCOUNT_UNHEALTHY alert when HF < safety line, default 1.2)

Example market query:

python scripts/fetch_markets.py --chain-id 56 --limit 200 (Core Pool default)
python scripts/fetch_markets.py --chain-id 56 --limit 200 --pool-scope all (all pools)

If API is unavailable, continue with transparent assumptions and mark output as estimate.

3) Run risk rules

Apply rules from references/risk-rules.md:

Compute health and safety buffer
Flag borrow-cap / liquidity constraints
Detect concentration risk (single volatile collateral)
Classify risk: Low / Medium / High

4) Produce actionable output

Always include:

Current state (key numbers)
Risk status (Low/Medium/High + why)
Safe range (max suggested extra borrow or required extra collateral)
Next best actions (2-4 concrete steps)

Prefer concise bullets and exact numbers.

Output format

Use this structure:

Summary: one-line verdict
Metrics: collateral, debt, health, utilization, APYs
Risk findings: top 2-4 risks
Recommended plan: concrete steps and limits
Assumptions: data freshness, missing fields, estimate flags

Guardrails

Never claim guaranteed safety or returns.
Never hide data gaps; explicitly note stale/missing data.
Default to conservative thresholds when uncertain.
Treat this as educational/risk tooling, not financial advice.
For real transactions: run simulate mode first; require explicit confirmation for broadcast.
For withdrawals: always predict post-withdraw HF; warn/block when predicted HF falls below safety line (default 1.2 unless user customizes).

Quick usage

One-command market check: python scripts/venus_check.py --symbol vUSDT
Market + auto wallet risk check: python scripts/venus_check.py --symbol vUSDT --wallet 0x...
What-if borrow (auto wallet): python scripts/venus_check.py --symbol vUSDT --wallet 0x... --extra-borrow 120
Manual fallback: python scripts/venus_check.py --symbol vUSDT --wallet 0x... --weighted-collateral 1500 --debt 1000
English brief mode: python scripts/venus_check.py --symbol vUSDT --wallet 0x... --output brief --lang en

Protocol separation

Venus Core scripts: scripts/ root (e.g. venus_*.js, fetch_markets.py, wallet_onchain_exposure.py).
Flux (Power by Fluid) scripts: scripts/flux/.
Choose protocol-specific scripts directly so other agents can route quickly without mixing workflows.

References

Protocol overview: references/protocol-overview.md
Risk thresholds and formulas: references/risk-rules.md
Contract/address notes: references/bnbchain-contracts.md
Terminology: references/glossary.md
Venus CLI cookbook: references/quick-commands.md
Flux CLI cookbook: references/flux-quick-commands.md
Flux BNB addresses: references/flux-bnb-addresses.json

name	venus-protocol-ops
description	Analyze Venus Protocol lending/borrowing positions on BNB Chain with risk-first guidance. Use when users ask about Venus markets, collateral/borrow decisions, health factor, liquidation risk, APY/utilization comparison, isolated pools, or "can I borrow X safely" style what-if checks.