Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ropl-btc avatar

Liquidium Borrow

ropl-btc/agent-skills

  • 5 installs
  • 1 repo stars
  • Updated July 29, 2026
  • ropl-btc/agent-skills

Runs Liquidium borrow, repay, and portfolio flows over the @liquidium/client SDK via a CLI, defaulting to accountless instant BTC-collateral loans.

About

Wraps the Liquidium non-custodial lending protocol in a guarded CLI covering quotes, instant loan creation, repayment, collateral top-ups, and portfolio dashboards. A developer uses it to build or operate agent-driven crypto lending workflows without connecting a wallet by default.

  • Accountless instant loans that need no wallet adapter, using client.instantLoans.create
  • Always surfaces LTV, liquidation thresholds, and APY with dry-run safety before any transfer

Liquidium Borrow by the numbers

  • 5 all-time installs (skills.sh)
  • Ranked #338 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ropl-btc/agent-skills --skill liquidium-borrow

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs5
repo stars★ 1
Last updatedJuly 29, 2026
Repositoryropl-btc/agent-skills ↗

What it does

Runs Liquidium borrow, repay, and portfolio flows over the @liquidium/client SDK via a CLI, defaulting to accountless instant BTC-collateral loans.

Files

SKILL.mdMarkdownGitHub ↗

Liquidium Borrow

Liquidium is a decentralized, non-custodial cross-chain lending protocol. The default agent flow is an accountless instant loan: the user provides collateral and destination addresses, Liquidium returns deposit and repayment targets, and the agent stores the loan reference for later status, repayment, or collateral top-up.

Liquidium docs: https://liquidium.fi/docs and SDK docs: https://liquidium.fi/docs/sdk.

Load The Right Reference

  • Instant loans, manual wallet users, wallet-access agents, saved loan records, repayment, add-collateral, and status tracking: read references/instant-loans.md.
  • Connected-wallet profile flows for supply, borrow, repay, withdraw, and portfolio dashboards: read references/profile-flows.md.
  • LTV, APY, health factor, liquidation thresholds, high-LTV warnings, and risk copy: read references/risk-and-liquidation.md.
  • SDK method shapes, CLI details, TypeScript examples, and troubleshooting: read references/sdk-methods.md.

Quick Start CLI

Run the wrapper from this skill directory:

<skill-path>/scripts/liquidium-borrow pools

The CLI bootstraps a pinned @liquidium/client package into ~/.cache/liquidium-borrow/node on first real CLI use. This requires npm/network access, installs with lifecycle scripts disabled, and is excluded from the packaged skill. Set LIQUIDIUM_CLI_CACHE_DIR to use a different cache location.

Created instant loans are saved by default under ~/.local/share/liquidium-borrow/loans/<ref>.json; local loan records live outside the repo. Set LIQUIDIUM_CLI_DATA_DIR to store records elsewhere. Use --no-save only when the caller has another durable record system.

Common commands:

<skill-path>/scripts/liquidium-borrow max-borrow --collateral-asset BTC --borrow-asset USDC --collateral-amount-decimal 0.0005
<skill-path>/scripts/liquidium-borrow quote --collateral-asset BTC --borrow-asset USDC --collateral-amount-decimal 0.0005 --borrow-amount-decimal 9
<skill-path>/scripts/liquidium-borrow instant-create --collateral-asset BTC --borrow-asset USDC --collateral-amount-decimal 0.0005 --borrow-amount-decimal 9 --borrow-destination 0x2222222222222222222222222222222222222222 --refund-destination bc1qrefunddestination
<skill-path>/scripts/liquidium-borrow loan-instructions --ref 8Y9AQQ --action status
<skill-path>/scripts/liquidium-borrow loan-instructions --ref 8Y9AQQ --action repay
<skill-path>/scripts/liquidium-borrow loan-instructions --ref 8Y9AQQ --action add-collateral
<skill-path>/scripts/liquidium-borrow deposit-status --ref 8Y9AQQ --txid <txid>
<skill-path>/scripts/liquidium-borrow instant-activities --ref 8Y9AQQ --filter active
<skill-path>/scripts/liquidium-borrow loan-list
<skill-path>/scripts/liquidium-borrow loan-show --ref 8Y9AQQ
<skill-path>/scripts/liquidium-borrow loan-tx --ref 8Y9AQQ --kind collateral --txid <txid>
<skill-path>/scripts/liquidium-borrow profile-summary --profile-id <profile-id>

The CLI prints JSON for reads and summaries. Use --json for raw SDK output where supported. It does not sign messages or broadcast wallet transactions; use wallet tools only after explicit user confirmation.

Decision Tree

1. If the user wants to borrow without a Liquidium profile or wallet connection, use instant loans. Read references/instant-loans.md. 2. If the user asks "how much can I borrow?", run max-borrow, then explain LTV and liquidation risk. Read references/risk-and-liquidation.md. 3. If the user wants to create, fund, repay, add collateral, or check an instant loan, use instant-create, loan-instructions, deposit-status, instant-get, instant-activities, and local loan records. 4. If the user lost the instant-loan reference, use instant-find --address <address> only to find candidates, then hydrate with instant-get or loan-instructions. 5. If the user wants a portfolio dashboard, repeated borrowing, connected-wallet supply, withdraw, or profile-level repay, use profile flows. Read references/profile-flows.md. 6. If the user wants ETH ERC-20 contract-interaction deposits, use profile-based client.lending.supply({ mechanism: "contractInteraction", ... }) with an EVM RPC and wallet adapter.

Safety Rules

  • Creating an instant loan request is not the same as transferring collateral. Before broadcasting any on-chain transfer, sending funds, or signing a wallet message, get explicit user confirmation of asset, amount, destination, chain, fee assumptions, and refund/borrow destination.
  • Treat borrow, supply, repay, and withdraw as financially consequential. Validate amounts, LTV, pool status, destination addresses, chain, and base-unit conversions before execution.
  • Always explain liquidation risk when discussing borrow capacity or high LTV. Include current LTV, max allowed LTV, liquidation threshold LTV, and estimated collateral liquidation price when available. Default to the short warning from references/risk-and-liquidation.md; add the high-LTV warning only when the quote is close to max LTV.
  • For instant loans, never reuse a collateral deposit target as a repayment target. Always refresh loan state and use the target for the exact action: collateral/add-collateral uses depositTarget; repayment uses repayment.target.
  • When returning instant-loan funding instructions, include depositWindowSeconds, an estimated absolute deposit deadline timestamp when available, and make the final line exactly specify the next transfer: Send <amount> <asset> to <deposit address>.
  • When the user says they sent collateral, run deposit-status --ref <ref>; include --txid <txid> if they provide one. Explain that Liquidium detection can take a few minutes after broadcast/confirmation, and report activity status, confirmations, and required confirmations when available.
  • Include the current borrowing interest rate/APY from the SDK when available. Never display raw scaled rate integers to users.
  • For instant loans, explain that the refund address is where collateral is returned after full repayment or when collateral cannot be applied, including failed/late/expired deposit cases. Explain that sending more collateral to the deposit target after the loan starts is a top-up that lowers LTV and improves health.
  • For instant loans, explain that partial repayments may reduce debt/LTV but do not trigger collateral withdrawal. The loan must be repaid in full to receive the full collateral amount back.
  • Do not expose, request, or store wallet private keys or seed phrases. Use existing wallet providers/adapters.
  • If the environment lacks a wallet or transfer tool, return exact transfer instructions rather than pretending to move funds.

Common Mistakes

  • Requiring a wallet adapter for instant loans. Instant loans do not need one.
  • Calling client.lending.borrow(...) for the default accountless flow. Use client.instantLoans.create(...).
  • Treating address recovery as canonical loan state. Hydrate candidates with instant-get.
  • Displaying raw bigint base units or raw fixed-point rates to users.
  • Ignoring frozen pools or validationErrors.
  • Confusing instant-loan collateral deposit targets with repayment targets.
  • Assuming profile-flow outflow.txid is present immediately after borrow.

Related skills

wshobsonSolidity SecurityCatch and fix critical Solidity vulnerabilities like reentrancy before deploying smart contracts.13k38.4kcaffeinelabsExtension Http OutcallsEnable their Internet Computer backend canister to make secure HTTP GET and POST requests to external APIs.10.3kokxOkx Dapp DiscoveryCorrectly route Chinese-language DeFi and on-chain queries to the right protocol plugins inside an agent workflow.9.5k315okxOkx Growth CompetitionGuide users through OKX OnchainOS competition reward status checks, atomic claims, and post-win contact collection via the onchainos CLI.9.1k315okxOkx Agent Payments ProtocolLet their AI agent create and fulfill on-chain payment links without leaving the coding session.8.7k315binanceQuery Token InfoGive your coding agent a Node CLI to search Binance tokens and pull metadata while you build crypto or DeFi features.6.1k946
Web3 & Blockchainfinance
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.