README
The builder skills: the instruction text AI agents load to build a specific token type or feature on BitBadges.
Builder skills
Reference copy of the skill instructions that agents load before they build a collection, for people who want to read what the agent reads.
A skill is a block of instruction text for one token type or feature: required standards, the approvals to create, the invariants to set, the tool call order, and the mistakes to avoid. The text lives in the SDK at packages/bitbadgesjs-sdk/src/builder/resources/skillInstructions.ts. The MCP builder tools serve it through get_skill_instructions, and the Claude Code plugin loads it when a skill is selected. These pages are generated from that file.
Fetch a skill
bb dev skills # list every skill id
bb dev skills smart-tokenMCP builder tools:
{ "tool": "get_skill_instructions", "arguments": { "skillId": "smart-token" } }Skills
| Skill | Category | What it covers |
|---|---|---|
| Address List | Token type | On-chain address list where membership = owning x1 of token ID 1. |
| Auction | Token type | Single-item auction with intent-based bidding. |
| Bounty | Token type | Escrow-based bounty with verifier arbitration. |
| Credit Token | Token type | Increment-only, non-transferable credit token purchased with any ICS20 denom. |
| Crowdfund | Token type | On-chain crowdfunding with goal tracking via mustOwnTokens. |
| Custom 2FA | Token type | Two-factor authentication for transfers using a secondary approval address |
| Fungible Token | Token type | Simple fungible token with fixed or unlimited supply and configurable mint/transfer approvals |
| Liquidity Pools | Token type | Liquidity pool standard with the "Liquidity Pools" protocol standard tag, used for tradable assets that can be swapped on a DEX |
| NFT Collection | Token type | Non-fungible token collection with unique token IDs, metadata URIs, and badge-based ownership |
| Payment obligations and reusable links | Token type | Versioned invoice obligations, payer groups, installments, partial targets, split payouts and reusable payment links built from native approvals. |
| Payment Protocol | Token type | Invoices, escrows, bounties, milestones, and multi-party agreements using coinTransfer-based approvals or IBC-backed smart token escrow |
| PaymentRequest | Token type | Agent-initiated payment request with no escrow. |
| Prediction Market | Token type | Binary prediction market with YES/NO outcome tokens, liquidity pool trading, and vote-based settlement |
| Products | Token type | Multi-product storefront with per-product pricing, supply limits, and optional burn-on-purchase. |
| Quest | Token type | Quest/reward collection: users complete criteria and claim a badge + coin payout |
| Smart Token | Token type | IBC-backed smart token with 1:1 backing and two required approvals (backing + unbacking) |
| Subscription | Token type | Time-based subscription token with recurring payment approvals and auto-deletion on expiry |
| Tradable NFTs | Standard | NFT marketplace standard enabling peer-to-peer transfers with the "NFTMarketplace" standard tag and NFTPricingDenom |
| Burnable | Approval | Allow token holders to burn tokens by sending them to the burn address, permanently removing them from circulation |
| Minting | Approval | Mint approval patterns including public mint, whitelist mint, creator-only mint, payment-gated mint, and escrow payouts |
| Multi-Sig / Voting | Approval | Require weighted quorum voting from multiple parties before transfers can proceed (multi-sig, governance, etc.) |
| Auto-Mint | Feature | Mint and distribute tokens to recipients at collection creation time using MsgTransferTokens |
| BB-402 Token-Gated Access | Feature | Token-gated access protocol where ownership of specific badges grants API/resource access |
| Transferability & Update Rules | Advanced | Lock collection permissions to make properties permanently immutable or permanently permitted |