venus-protocol-ops

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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "venus-protocol-ops" with this command: npx skills add zed-venus/venus-agent-skills

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:

  1. Current state (key numbers)
  2. Risk status (Low/Medium/High + why)
  3. Safe range (max suggested extra borrow or required extra collateral)
  4. 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Web3

Model Tester

Test agents or models against predefined test cases to validate model routing, performance, and output quality. Use when: (1) verifying a specific agent or m...

Registry SourceRecently Updated
0135
nandorocker
Web3

Make Git Escrow

Create a new git escrow bounty for a test suite. Use when the user wants to submit a challenge with escrowed token rewards for passing a failing test suite....

Registry SourceRecently Updated
070
mlegls
Web3

Fulfill Git Escrow

Fulfill a git escrow bounty by writing a solution or submitting an existing one. Use when the user wants to solve a test suite challenge, write code to pass...

Registry SourceRecently Updated
069
mlegls