About alby-bitcoin-builder
alby-bitcoin-builder is a skill for developers building apps with Bitcoin Lightning wallet capabilities. It covers wallet operations, Lightning utilities, and browser payment UI components.
Key features
- 01NWC wallet payments and notifications
- 02Balance, transactions, and wallet info
- 03Invoice parsing and verification
- 04Lightning address invoice requests
- 05Bitcoin Connect UI for React, Vue, and HTML
Use cases
- 01Add Lightning payments to an app
- 02Retrieve wallet activity and balance
- 03Connect browser wallets and accept payments
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ getalby/ builder-skill --skill alby-bitcoin-builderAfter installing, type/alby-bitcoin-builderin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/automated-testing.mdproduction-wallets.mdtesting-wallets.mdreferences/bitcoin-connect/bitcoin-connect.mdbundle.d.tsreact.bundle.d.tsreferences/lightning-tools/402-server.md402.mdfiat.mdindex.d.tsinvoice.mdlightning-tools.mdlnurl.mdreferences/nwc-client/hold-invoices.mdnotifications.mdnwc-client.mdnwc.d.tspay-invoice.mdDetails
From the project READMEUsage
Use this skill to understand how to build apps that require bitcoin lightning wallet capabilities.
- NWC Client: Interact with a wallet to send and receive payments, subscribe to real-time payment notifications (preferred over polling), fetch balance, transaction list, and wallet info
- Lightning Tools: Request invoices from a lightning address, parse BOLT-11 invoices, verify a preimage for a BOLT-11 invoice, LNURL-Verify, do bitcoin <-> fiat conversions
- Bitcoin Connect: Browser-only UI components for connecting wallets and accepting payments in React, Vue, or pure HTML web apps
Prefer Typescript
When the user says to use "JS" or "Javascript" or "NodeJS" or something similar, use typescript unless the user explicitly says to not use typescript or the project does not support it.
Imports
Do NOT import from the dist directory.
Read the Typings
Based on what functionality you require, read the relevant typings:
Testing Wallets
If the user doesn't have a wallet yet, or needs one for development or testing, testing wallets can be created with a single request.
Automated Testing
Testing wallets should be used for automated testing.
It is recommended to write tests so that the agent can test its own work and fix bugs itself without requiring human input.
Production Wallet
If they do not have a wallet yet here are some options