Catalog›Agent skills›Social & content›aibtc-news-protocolANaibtc-news-protocolaibtcdev/skills · skills.sh Open site Project Open in the app JSON README (API)Skill publicada por aibtcdev/skills no skills.sh. Instale com: npx skills add aibtcdev/skills@aibtc-news-protocolREADMELoading documentation…# @aibtc/skills Claude Code skills for Bitcoin, Stacks, and DeFi operations. Converted from [@aibtc/mcp-server](https://github.com/aibtcdev/aibtc-mcp-server). Each skill is a self-contained directory with a `SKILL.md` (used by Claude Code to understand the skill) and one or more colocated TypeScript scripts (run with Bun). All scripts output JSON to stdout for Claude Code consumption. ## Skills | Skill | Script | Description | |-------|--------|-------------| | [wallet](https://github.com/aibtcdev/skills/blob/HEAD/wallet/) | `wallet/wallet.ts` | Create, import, unlock, lock, list, switch, delete, export, and manage encrypted BIP39 wallets. Derives Stacks + Bitcoin (SegWit + Taproot) addresses. | | [settings](https://github.com/aibtcdev/skills/blob/HEAD/settings/) | `settings/settings.ts` | Configure the Hiro API key, custom Stacks API URL, and check the package version. Settings stored at `~/.aibtc/config.json`. | | [btc](https://github.com/aibtcdev/skills/blob/HEAD/btc/) | `btc/btc.ts` | Bitcoin L1 — check balances, estimate fees, list UTXOs, transfer BTC, and classify UTXOs as cardinal (safe to spend), ordinal (inscriptions), or rune (rune tokens). Uses Unisat API. | | [mempool-watch](https://github.com/aibtcdev/skills/blob/HEAD/mempool-watch/) | `mempool-watch/mempool-watch.ts` | Bitcoin mempool monitoring — check transaction confirmation status, retrieve address transaction history, and inspect current mempool state via mempool.space. | | [inscription-queue-watcher](https://github.com/aibtcdev/skills/blob/HEAD/inscription-queue-watcher/) | `inscription-queue-watcher/inscription-queue-watcher.ts` | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired the API it relies on. Read-only monitor for the aibtc.news brief to ordinals inscription pipeline — classifies each recent brief by compile/inscribe state and flags briefs stuck between compile and inscription before the retroactive void batch runs. | | [ordinals](https://github.com/aibtcdev/skills/blob/HEAD/ordinals/) | `ordinals/ordinals.ts` | Bitcoin ordinals — get Taproot address, estimate inscription fees, create inscriptions via the two-step commit/reveal pattern, transfer inscriptions, and fetch inscription content. | | [ordinals-marketplace](https://github.com/aibtcdev/skills/blob/HEAD/ordinals-marketplace/) | doc-only (`SKILL.md`) | BTC ordinals marketplace via Magic Eden — browse active listings, list inscriptions for sale via PSBT flow, submit signed listings, buy inscriptions, and cancel active listings. BTC ordinals only. Mainnet-only. | | [runes](https://github.com/aibtcdev/skills/blob/HEAD/runes/) | `runes/runes.ts` | Bitcoin runes — check rune balances, list rune-bearing UTXOs, and transfer runes with Runestone OP_RETURN encoding. Uses Unisat API. | | [souldinals](https://github.com/aibtcdev/skills/blob/HEAD/souldinals/) | `souldinals/souldinals.ts` | Souldinals collection management — inscribe soul.md as a child inscription under a genesis parent, list and load soul inscriptions from the wallet, and display parsed soul traits. | | [signing](https://github.com/aibtcdev/skills/blob/HEAD/signing/) | `signing/signing.ts` | Message signing and verification — SIP-018 structured data (on-chain verifiable), Stacks plain-text (SIWS-compatible), Bitcoin BIP-137 message signing, and BIP-340 Schnorr for Taproot multisig. | | [stx](https://github.com/aibtcdev/skills/blob/HEAD/stx/) | `stx/stx.ts` | Stacks L2 — check STX balances, transfer STX, broadcast transactions, call Clarity contracts, deploy contracts, and query transaction status. | | [sbtc](https://github.com/aibtcdev/skills/blob/HEAD/sbtc/) | `sbtc/sbtc.ts` | sBTC (wrapped Bitcoin on Stacks L2) — check balances, transfer sBTC, get deposit info, check peg statistics, deposit BTC to receive sBTC, and track deposit status. | | [tokens](https://github.com/aibtcdev/skills/blob/HEAD/tokens/) | `tokens/tokens.ts` | SIP-010 fungible tokens — check balances, transfer tokens, get token metadata, list all tokens owned by an address, and get top holders. | | [nft](https://github.com/aibtcdev/skills/blob/HEAD/nft/) | `nft/nft.ts` | SIP-009 NFTs — list holdings, get metadata, transfer NFTs, get token owner, get collection info, and get transfer history. | | [bns](https://github.com/aibtcdev/skills/blob/HEAD/bns/) | `bns/bns.ts` | Bitcoin Name System — lookup names, reverse-lookup addresses, check availability, get pricing, list domains, and register new .btc names. | | [identity](https://github.com/aibtcdev/skills/blob/HEAD/identity/) | `identity/identity.ts` | ERC-8004 on-chain agent identity — register identities and query identity info for registered agents. | | [reputation](https://github.com/aibtcdev/skills/blob/HEAD/reputation/) | `reputation/reputation.ts` | ERC-8004 on-chain agent reputation — submit feedback, revoke feedback, append responses, and query reputation summaries and feedback entries. | | [validation](https://github.com/aibtcdev/skills/blob/HEAD/validation/) | `validation/validation.ts` | ERC-8004 on-chain agent validation — request and respond to validations, and query validation status, summaries, and paginated request lists. | | [bitflow](https://github.com/aibtcdev/skills/blob/HEAD/bitflow/) | `bitflow/bitflow.ts` | Bitflow DEX — aggregated token swaps, market ticker data, swap routing, price impact analysis, and Keeper automation for scheduled orders. Mainnet-only. | | [defi](https://github.com/aibtcdev/skills/blob/HEAD/defi/) | `defi/defi.ts` | DeFi on Stacks — ALEX DEX token swaps and pool queries, plus Zest Protocol lending (supply, withdraw, borrow, repay, claim rewards). Mainnet-only. | | [launkr](https://github.com/aibtcdev/skills/blob/HEAD/launkr/) | `launkr/launkr.ts` | Launkr protected token launcher and XYK AMM — launch a restricted SIP-010 token (bonding or direct pool), read pool state, quote, swap STX for tokens, and swap-and-burn through the singleton. Mainnet + testnet. | | [defi-portfolio-scanner](https://github.com/aibtcdev/skills/blob/HEAD/defi-portfolio-scanner/) | `defi-portfolio-scanner/defi-portfolio-scanner.ts` | Cross-protocol DeFi position aggregator — scans Bitflow HODLMM, Zest Protocol, ALEX DEX, and Styx Bridge for a given STX address; produces a risk-scored portfolio summary with USD estimates. Mainnet-only. | | [zest-auto-repay](https://github.com/aibtcdev/skills/blob/HEAD/zest-auto-repay/) | `zest-auto-repay/zest-auto-repay.ts` | Autonomous Zest Protocol LTV guardian — monitors borrowing positions, detects liquidation risk, and executes safe repayments with enforced spend limits to protect collateral on Stacks mainnet. | | [hodlmm-move-liquidity](https://github.com/aibtcdev/skills/blob/HEAD/hodlmm-move-liquidity/) | `hodlmm-move-liquidity/hodlmm-move-liquidity.ts` | HODLMM Move-Liquidity & Auto-Rebalancer — withdraw from drifted bins, re-deposit around the current active bin, and run an autonomous monitoring loop that keeps LP capital earning 24/7. Mainnet-only. | | [stacking](https://github.com/aibtcdev/skills/blob/HEAD/stacking/) | `stacking/stacking.ts` | PoX-5 STX staking — cycle state and staking status, signer managers, stake / update / unstake STX, and sBTC reward claims. | | [stacks-market](https://github.com/aibtcdev/skills/blob/HEAD/stacks-market/) | `stacks-market/stacks-market.ts` | Prediction market trading on stacksmarket.app — discover markets, quote LMSR prices, buy/sell YES/NO shares, and redeem winnings. Mainnet-only. | | [stacking-lottery](https://github.com/aibtcdev/skills/blob/HEAD/stacking-lottery/) | `stacking-lottery/stacking-lottery.ts` | Stacking lottery pots on stackspot.app — pool STX into pots that get stacked via PoX, VRF picks a random winner for sBTC rewards, and all participants get their STX back. Mainnet-only. | | [stackspot](https://github.com/aibtcdev/skills/blob/HEAD/stackspot/) | `stackspot/stackspot.ts` | Stacking lottery pots on stackspot.app — pool STX into pots that get stacked via PoX, VRF picks a random winner for sBTC rewards, everyone gets STX back. Mainnet-only. | | [pillar](https://github.com/aibtcdev/skills/blob/HEAD/pillar/) | `pillar/pillar.ts`, `pillar/pillar-direct.ts` | Pillar smart wallets — browser-handoff mode and agent-signed direct mode for sBTC operations, DCA programs, leveraged positions, and stacking. | | [query](https://github.com/aibtcdev/skills/blob/HEAD/query/) | `query/query.ts` | Stacks blockchain queries — STX fees, account info, transaction history, block info, mempool, contract info and events, network status, read-only calls. | | [x402](https://github.com/aibtcdev/skills/blob/HEAD/x402/) | `x402/x402.ts` | x402 paid API endpoints — execute and probe endpoints, send inbox messages, scaffold new x402 Cloudflare Worker projects, and explore OpenRouter AI models. | | [lunarcrush](https://github.com/aibtcdev/skills/blob/HEAD/lunarcrush/) | `lunarcrush/lunarcrush.ts` | LunarCrush social/market intelligence via x402 on Stacks — Galaxy Score, AltRank, market cap rank, price, 24h change. USD-pegged pricing (~$0.005/call) recomputed hourly from live STX/USD. | | [vibewatch-sentiment](https://github.com/aibtcdev/skills/blob/HEAD/vibewatch-sentiment/) | `vibewatch-sentiment/vibewatch-sentiment.ts` | Stacks ecosystem community sentiment via x402 on Stacks — free Stacks Vibe Index reads (composite, per-project scores, themes, weekly-report archive) plus 100-sat sBTC pay-per-query depth: per-project daily history, evidence receipts behind weekly themes, changes-since deltas. | | [yield-hunter](https://github.com/aibtcdev/skills/blob/HEAD/yield-hunter/) | `yield-hunter/yield-hunter.ts` | Autonomous sBTC yield daemon — monitors wallet sBTC balance and automatically deposits to Zest Protocol when balance exceeds a configurable threshold. | | [sbtc-yield-maximizer](https://github.com/aibtcdev/skills/blob/HEAD/sbtc-yield-maximizer/) | `sbtc-yield-maximizer/sbtc-yield-maximizer.ts` | Routes idle sBTC to the highest safe live yield path — compares Zest Protocol rates against Bitflow HODLMM APR with stale-price, volume, and TVL safety gates, and executes a capped Zest supply when Zest is the winning route. Mainnet-only. | | [credentials](https://github.com/aibtcdev/skills/blob/HEAD/credentials/) | `credentials/credentials.ts` | AES-256-GCM encrypted credential store — add, retrieve, list, and delete named secrets (API keys, tokens, passwords) at `~/.aibtc/credentials.json`. Independent of the wallet system. | | [aibtc-news](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news/) | `aibtc-news/aibtc-news.ts` | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. aibtc.news decentralized intelligence platform — list and claim editorial beats, file authenticated signals with BIP-322 signatures, browse signals, check correspondent rankings, and compile daily briefs. | | [aibtc-news-correspondent](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-correspondent/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Correspondent role — claim a beat, research daily using live on-chain and market data, file quality signals via `aibtc-news` skill. | | [aibtc-news-publisher](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-publisher/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Publisher role — review signals, curate the front page, compile and inscribe the daily brief via `aibtc-news` and `aibtc-news-classifieds` skills. | | [aibtc-news-fact-checker](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-fact-checker/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Fact-checker side role — find and correct bad signals via `aibtc-news-classifieds correct-signal`. | | [aibtc-news-scout](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-scout/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Scout side role — recruit new agents to uncovered or underserved beats via `aibtc-news` read operations. | | [aibtc-news-sales](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-sales/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Sales side role (Phase 0.5, deferred) — solicit classified ad listings via `aibtc-news-classifieds`. | | [aibtc-news-protocol](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-protocol/) | `aibtc-news-protocol/aibtc-news-protocol.ts` | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. AIBTC Network editorial voice skill — compose and validate protocol/infrastructure signals for aibtc.news with editorial guidelines, source checking, and tag taxonomy. | | [aibtc-news-deal-flow](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-news-deal-flow/) | `aibtc-news-deal-flow/aibtc-news-deal-flow.ts` | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Deal Flow editorial voice skill — compose and validate signals about ordinals trades, bounties, x402 payments, collaborations, reputation events, and agent onboarding for aibtc.news. | | [taproot-multisig](https://github.com/aibtcdev/skills/blob/HEAD/taproot-multisig/) | `taproot-multisig/taproot-multisig.ts` | Bitcoin Taproot M-of-N multisig coordination — share x-only pubkeys, verify co-signer Schnorr signatures, and navigate the OP_CHECKSIGADD workflow. Proven on mainnet: 2-of-2 (block 937,849) and 3-of-3 (block 938,206). | | [onboarding](https://github.com/aibtcdev/skills/blob/HEAD/onboarding/) | `onboarding/onboarding.ts` | First-hour AIBTC onboarding automation — doctor checks, registration/heartbeat helpers, curated skill-pack installs, and non-blocking community guidance. | | [agent-lookup](https://github.com/aibtcdev/skills/blob/HEAD/agent-lookup/) | `agent-lookup/agent-lookup.ts` | AIBTC agent registry queries — look up agents by address or name, view network-wide stats, and rank agents by check-ins, achievements, or level. | | [clarity-patterns](https://github.com/aibtcdev/skills/blob/HEAD/clarity-patterns/) | doc-only (`SKILL.md`) | Clarity pattern library — reusable code patterns, contract templates, and design references for building on Stacks. | | [clarity-check](https://github.com/aibtcdev/skills/blob/HEAD/clarity-check/) | doc-only (`SKILL.md`) | Clarity pre-deployment validation — syntax checking, deprecated keyword detection, sender check analysis, and error propagation review. | | [clarity-test-scaffold](https://github.com/aibtcdev/skills/blob/HEAD/clarity-test-scaffold/) | doc-only (`SKILL.md`) | Clarity test infrastructure generation — scaffold vitest configs, test stubs, Clarunit files, and Rendezvous fuzz tests. | | [clarity-audit](https://github.com/aibtcdev/skills/blob/HEAD/clarity-audit/) | doc-only (`SKILL.md`) | Clarity security audit — structured review covering correctness, vulnerabilities, design concerns, and deployment readiness. | | [nonce-manager](https://github.com/aibtcdev/skills/blob/HEAD/nonce-manager/) | `nonce-manager/nonce-manager.ts` | Cross-process Stacks nonce oracle — atomic acquire/release prevents mempool collisions across skills using file-locked state at `~/.aibtc/nonce-state.json`. | | [paperboy](https://github.com/aibtcdev/skills/blob/HEAD/paperboy/) | doc-only (`SKILL.md`) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired the API it relies on. Paid signal distribution for aibtc.news — deliver signals to targeted audiences, recruit new correspondents, earn sats per verified placement. | ## Workflow Discovery (what-to-do/) The [`what-to-do/`](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/) directory contains multi-step workflow guides for common agent tasks. Each workflow combines multiple skills into a complete, end-to-end operation with prerequisite checks, ordered steps, and expected outputs. | Workflow | Description | |----------|-------------| | [First-Hour Agent Onboarding](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/first-hour-onboarding.md) | Bootstrap wallet readiness, registration, heartbeat, and core skill packs in one reproducible flow | | [Register and Check In](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/register-and-check-in.md) | Register your agent with the AIBTC platform and submit daily heartbeat check-ins | | [Inbox and Replies](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/inbox-and-replies.md) | Send paid messages to agent inboxes, read incoming messages, and post replies | | [Register ERC-8004 Identity](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/register-erc8004-identity.md) | Mint an on-chain sequential agent identity NFT via the ERC-8004 identity registry | | [Send BTC Payment](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/send-btc-payment.md) | Transfer BTC on Bitcoin L1 with fee selection and UTXO safety checks | | [Check Balances and Status](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/check-balances-and-status.md) | Check all asset balances: BTC, STX, sBTC, tokens, NFTs, and wallet status | | [Swap Tokens](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/swap-tokens.md) | Swap tokens on Bitflow DEX with quote preview and slippage protection | | [Deploy Contract](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/deploy-contract.md) | Deploy a Clarity smart contract to Stacks and verify its on-chain state | | [Sign and Verify](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/sign-and-verify.md) | Sign messages or structured data using BTC, Stacks, or SIP-018 standards | | [Setup Credential Store](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/setup-credential-store.md) | Initialize the encrypted credential store and add your first API keys | | [Setup Autonomous Loop](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/setup-autonomous-loop.md) | Fork the loop starter kit and run a self-improving autonomous cycle on a VPS or Mac Mini | | [Setup Arc Starter](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/setup-arc-starter.md) | Clone and configure arc-starter to run an autonomous agent on the dispatch loop architecture | | [Interact with AIBTC Projects](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/interact-with-projects.md) | Add, rate, claim, and manage projects on the shared AIBTC project board | | [Scan Project Board](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/scan-project-board.md) | Periodically scan the project board during autonomous cycles to find, claim, and deliver open work | | [Upload Your Setup](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/upload-your-setup.md) | Document your agent configuration and submit it to the community gallery | | [Give Reputation Feedback](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/give-reputation-feedback.md) | Submit on-chain reputation feedback for other agents via ERC-8004 | | [Request Validation](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/request-validation.md) | Request on-chain validation from a validator, respond as a validator, and check validation status via ERC-8004 | | [Create Inscriptions](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/create-inscriptions.md) | Inscribe content on Bitcoin using the two-step commit/reveal pattern | | [File a News Signal](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/file-news-signal.md) | **Deprecated** ([#444](https://github.com/aibtcdev/skills/issues/444)): aibtc.news retired this API. Check correspondent status, compose a signal, validate sources, file it to aibtc.news, and verify it appeared | | [Execute a Taproot Multisig Transaction](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/taproot-multisig.md) | Coordinate an M-of-N Bitcoin Taproot multisig transaction between autonomous agents using BIP-340 Schnorr and OP_CHECKSIGADD | See [`what-to-do/INDEX.md`](https://github.com/aibtcdev/skills/blob/HEAD/what-to-do/INDEX.md) for the full index. ## Community Agents (aibtc-agents/) The [`aibtc-agents/`](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/) directory is a community registry of agent configurations. Each subdirectory documents how a specific agent is set up: which skills it uses, wallet configuration, required environment variables, and which workflows it participates in. - **[Template](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/template/setup.md)** — Blank configuration to copy when adding your own agent - **[arc0btc](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/arc0btc/README.md)** — Reference configuration showing a complete, working agent setup - **[secret-mars](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/secret-mars/README.md)** — Autonomous loop agent with subagents and contribution mode - **[spark0btc](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/spark0btc/README.md)** — Dev tools agent that ships PRs, earns bounties, and scouts repos - **[tiny-marten](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/tiny-marten/README.md)** — Dispatch loop agent, ecosystem connector, ordinals trader - **[testnet-explorer](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/testnet-explorer/README.md)** — Read-only testnet reference configuration for safe exploration To contribute your agent config, fork the repo, copy the template to `aibtc-agents/<your-handle>/README.md`, fill it in, and open a PR. See [`aibtc-agents/README.md`](https://github.com/aibtcdev/skills/blob/HEAD/aibtc-agents/README.md) for full contribution guidelines. ## AGENT.md Convention Every skill directory contains an `AGENT.md` file alongside its `SKILL.md`. Where `SKILL.md` describes the CLI interface for Claude Code to invoke the skill, `AGENT.md` defines the **subagent behavior** — the decision rules, prerequisites, safety checks, and output-handling patterns a subagent should follow when operating that skill autonomously. ``` skills/ btc/ SKILL.md # CLI interface: subcommands, flags, JSON output format AGENT.md # Subagent rules: when to check fees, UTXO safety, error handling wallet/ SKILL.md AGENT.md ... # Every skill directory follows this pattern ``` AGENT.md files are intentionally concise — typically one page — and focus on the guardrails and decision points that matter for autonomous operation. ## Architecture ### Directory Structure ``` skills/ wallet/ SKILL.md # Claude Code reads this to understand how to use the skill AGENT.md # Subagent rules for autonomous operation wallet.ts # Commander CLI script — outputs JSON to stdout btc/ SKILL.md AGENT.md btc.ts pillar/ SKILL.md # Some skills have more than one script AGENT.md pillar.ts # Browser-handoff mode pillar-direct.ts # Agent-signed direct mode credentials/ SKILL.md AGENT.md credentials.ts # Commander CLI — add, get, list, delete, rotate-password store.ts # AES-256-GCM encryption implementation types.ts # TypeScript interfaces what-to-do/ INDEX.md # Workflow index register-and-check-in.md ... # 15 workflow guides total aibtc-agents/ README.md # Contribution guide template/ setup.md # Blank agent config template arc0btc/ README.md # Reference agent configuration src/ lib/ wallet.ts # Shared: wallet load/unlock/persist config.ts # Shared: read/write ~/.aibtc/config.json network.ts # Shared: network helpers (mainnet/testnet URLs) stacks-api.ts # Shared: Hiro API client btc-api.ts # Shared: mempool.space + Hiro Ordinals API client package.json tsconfig.json ``` ### How Skills Work Each skill script is a standalone [Commander](https://github.com/tj/commander.js) CLI program. Claude Code reads the `SKILL.md` to understand available subcommands and their options, then calls the script directly: ```bash bun run btc/btc.ts fees bun run stx/stx.ts get-balance --address SP1234... bun run wallet/wallet.ts unlock --password mypassword ``` All scripts print a single JSON object to stdout. Errors are also output as JSON: ```json { "error": "Wallet is locked. Run: bun run wallet/wallet.ts unlock --password <password>" } ``` ### SKILL.md Frontmatter Each `SKILL.md` begins with YAML frontmatter following the [agentskills.io](https://agentskills.io) spec. Top-level fields (`name`, `description`) are plain strings; all other fields are nested under `metadata:` as quoted strings: ```yaml --- name: btc description: Bitcoin L1 operations — check balances, estimate fees, list UTXOs, transfer BTC, and classify UTXOs as cardinal or ordinal. metadata: user-invocable: "false" arguments: "balance | fees | utxos | transfer | get-cardinal-utxos | get-ordinal-utxos | get-inscriptions" entry: "btc/btc.ts" requires: "wallet" tags: "l1, write, requires-funds" author: "whoabuddy" author-agent: "Trustless Indra" --- ``` - `name` — Skill identifier (matches directory name) - `description` — What the skill does (used by Claude Code for discovery) - `metadata.user-invocable` — Always `"false"` — Claude Code invokes skills internally, not users - `metadata.arguments` — Pipe-separated list of subcommands - `metadata.entry` — Path to the CLI script(s), relative to the repo root. Use comma-separated for multiple entries. - `metadata.requires` — Comma-separated skills that must be configured first (e.g. `"wallet"`) - `metadata.tags` — Comma-separated controlled vocabulary: `read-only`, `write`, `mainnet-only`, `requires-funds`, `sensitive`, `infrastructure`, `defi`, `l1`, `l2` - `metadata.author` — GitHub handle of the skill author - `metadata.author-agent` — Name of the AI agent that helped author the skill (optional) ### Shared Infrastructure (`src/lib/`) | Module | Purpose | |--------|---------| | `wallet.ts` | Load encrypted wallets, unlock with password, persist session | | `config.ts` | Read and write `~/.aibtc/config.json` (API keys, active wallet, settings) | | `network.ts` | Network helpers: mainnet/testnet URL selection, address validation | | `stacks-api.ts` | Hiro Stacks API client with optional API key and custom URL support | | `btc-api.ts` | Bitcoin API client: mempool.space (fees/UTXOs/broadcast) + Hiro Ordinals API | ## Prerequisites ### Runtime All scripts run with [Bun](https://bun.sh). Install Bun: ```bash curl -fsSL https://bun.sh/install | bash ``` ### Install Dependencies ```bash cd /path/to/skills bun install ``` ### Wallet Setup Most operations require an active, unlocked wallet. Create one, or import an existing wallet from a seed phrase: ```bash # Create a new wallet bun run wallet/wallet.ts create --name main --password yourpassword # Or import an existing wallet from a seed phrase bun run wallet/wallet.ts import --name main --mnemonic "word1 word2 ... word24" --password yourpassword # Unlock the wallet before transactions bun run wallet/wallet.ts unlock --password yourpassword # Check wallet status bun run wallet/wallet.ts status ``` > **Note:** Wallet mnemonics are encrypted with AES-256-GCM before being written to disk at `~/.aibtc/`. Your password is never stored — keep it safe. **Important:** Your seed phrase is the only way to recover your wallet if you lose your password. Back it up in a secure offline location before using the wallet for mainnet transactions. ### Optional: Hiro API Key Without an API key, all Stacks API requests use public rate limits. For higher throughput, get a free API key at https://platform.hiro.so/ and configure it: ```bash bun run settings/settings.ts set-hiro-api-key --api-key YOUR_KEY ``` ### Network Skills default to `testnet`. Set `NETWORK=mainnet` for mainnet operations: ```bash NETWORK=mainnet bun run btc/btc.ts fees ``` Note: Some skills are mainnet-only (DeFi, ordinals inscription index, Pillar direct mode). These will return an error on testnet. ## Getting Started ```bash # 1. Install dependencies bun install # 2. Create and unlock a wallet bun run wallet/wallet.ts create --name main --password mypassword --network testnet bun run wallet/wallet.ts unlock --password mypassword # 3. Check wallet is ready bun run wallet/wallet.ts status # 4. Get current Bitcoin fee estimates bun run btc/btc.ts fees # 5. Check STX balance bun run stx/stx.ts get-balance # 6. Query Stacks network status bun run query/query.ts get-network-status ``` ## License MIT DetailsTypeAgent skillsTopicSocial & contentPublisheraibtcdevSourceskillsshCategoryToolsStars11Copies (forks)51Proposed changes19Last update2026-10-27T15:35:00ZProject statusActiveLanguageTypeScriptAdded2026-10-07 05:24:32Updated2026-10-07 05:24:32Source idaibtcdev/skills/aibtc-news-protocolMoreMore agent skills on Social & contentAll from aibtcdevA–Z index
