How do I install the Styx skill?

Run npx skillmds@latest add aibtcdev/styx in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Styx?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

aibtcdev (@aibtcdev) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Styx by aibtcdev — Agent Skill

Name: Styx
Author: aibtcdev

File contents

Styx Skill

Trustless BTC→sBTC conversion via the Styx protocol by FaktoryFun. Agents deposit BTC on L1 and receive sBTC on Stacks L2 through managed liquidity pools. Uses @faktoryfun/styx-sdk.

How It Works

Check pool liquidity — pool-status shows available sBTC in the pool
Create deposit reservation — deposit reserves pool liquidity and returns a deposit ID
Build & sign transaction — The SDK provides UTXOs and deposit address; the agent builds and signs locally with @scure/btc-signer
Broadcast — Signed transaction is broadcast to mempool.space
Track status — status monitors the deposit through confirmation

Pools

Pool ID	Type	Min Deposit	Max Deposit	Swap Types
`main`	Legacy	10,000 sats	300,000 sats	sbtc, usda, pepe
`aibtc`	AI BTC	10,000 sats	1,000,000 sats	sbtc, aibtc

Subcommands

pool-status

bun run styx/styx.ts pool-status [--pool main|aibtc]

Returns realAvailable, estimatedAvailable (BTC), and lastUpdated.

pools

bun run styx/styx.ts pools

Lists all available pools with configs and active status.

fees

bun run styx/styx.ts fees

Returns current Bitcoin network fee estimates (low/medium/high in sat/vB).

price

bun run styx/styx.ts price

Returns current BTC price in USD.

deposit

bun run styx/styx.ts deposit --amount <sats> --stx-receiver <addr> --btc-sender <addr> [--pool main|aibtc] [--fee low|medium|high]

Full headless deposit flow: creates reservation, prepares PSBT, signs with wallet key, broadcasts to mempool.space, and updates deposit status. Requires an unlocked wallet.

status

bun run styx/styx.ts status --id <deposit-id>
bun run styx/styx.ts status --txid <btc-txid>

Check deposit status by deposit ID or Bitcoin transaction ID.

history

bun run styx/styx.ts history --address <stx-addr>

Get deposit history for a Stacks address.

Deposit Statuses

initiated — Deposit record created, liquidity reserved
broadcast — Bitcoin tx broadcast to mempool
processing — At least 1 BTC confirmation
confirmed — Required confirmations reached, sBTC minted
refund-requested — User requested refund
canceled — Deposit canceled, liquidity released

Notes

Always check pool-status before depositing to verify sufficient liquidity
Update deposit status after broadcast — this is critical for accurate pool accounting
Min deposit: 10,000 sats (0.0001 BTC). Max varies by pool.
The SDK uses a pre-configured API key for the Styx backend

---name: styxdescription: BTC→sBTC conversion via Styx protocol (btc2sbtc.com) — pool status, fee estimates, deposit creation, PSBT signing, broadcast, and deposit tracking.---# Styx SkillTrustless BTC→sBTC conversion via the Styx protocol by FaktoryFun. Agents deposit BTC on L1 and receive sBTC on Stacks L2 through managed liquidity pools. Uses `@faktoryfun/styx-sdk`.## How It Works1. **Check pool liquidity** — `pool-status` shows available sBTC in the pool2. **Create deposit reservation** — `deposit` reserves pool liquidity and returns a deposit ID3. **Build & sign transaction** — The SDK provides UTXOs and deposit address; the agent builds and signs locally with `@scure/btc-signer`4. **Broadcast** — Signed transaction is broadcast to mempool.space5. **Track status** — `status` monitors the deposit through confirmation## Pools| Pool ID | Type | Min Deposit | Max Deposit | Swap Types ||---------|------|-------------|-------------|------------|| `main` | Legacy | 10,000 sats | 300,000 sats | sbtc, usda, pepe || `aibtc` | AI BTC | 10,000 sats | 1,000,000 sats | sbtc, aibtc |## Subcommands### pool-status```bun run styx/styx.ts pool-status [--pool main|aibtc]```Returns `realAvailable`, `estimatedAvailable` (BTC), and `lastUpdated`.### pools```bun run styx/styx.ts pools```Lists all available pools with configs and active status.### fees```bun run styx/styx.ts fees```Returns current Bitcoin network fee estimates (low/medium/high in sat/vB).### price```bun run styx/styx.ts price```Returns current BTC price in USD.### deposit```bun run styx/styx.ts deposit --amount <sats> --stx-receiver <addr> --btc-sender <addr> [--pool main|aibtc] [--fee low|medium|high]```Full headless deposit flow: creates reservation, prepares PSBT, signs with wallet key, broadcasts to mempool.space, and updates deposit status. Requires an unlocked wallet.### status```bun run styx/styx.ts status --id <deposit-id>bun run styx/styx.ts status --txid <btc-txid>```Check deposit status by deposit ID or Bitcoin transaction ID.### history```bun run styx/styx.ts history --address <stx-addr>```Get deposit history for a Stacks address.## Deposit Statuses- `initiated` — Deposit record created, liquidity reserved- `broadcast` — Bitcoin tx broadcast to mempool- `processing` — At least 1 BTC confirmation- `confirmed` — Required confirmations reached, sBTC minted- `refund-requested` — User requested refund- `canceled` — Deposit canceled, liquidity released## Notes- Always check `pool-status` before depositing to verify sufficient liquidity- Update deposit status after broadcast — this is critical for accurate pool accounting- Min deposit: 10,000 sats (0.0001 BTC). Max varies by pool.- The SDK uses a pre-configured API key for the Styx backend

Frequently asked questions

Styx