# README

<!-- generated by site/scripts/gen-skills.ts; do not hand-edit -->

# 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

```bash
bb dev skills            # list every skill id
bb dev skills smart-token
```

MCP builder tools:

```json
{ "tool": "get_skill_instructions", "arguments": { "skillId": "smart-token" } }
```

## Skills

| Skill | Category | What it covers |
| --- | --- | --- |
| [Address List](https://docs.bitbadges.io/agents/skills/address-list) | Token type | On-chain address list where membership = owning x1 of token ID 1. |
| [Auction](https://docs.bitbadges.io/agents/skills/auction) | Token type | Single-item auction with intent-based bidding. |
| [Bounty](https://docs.bitbadges.io/agents/skills/bounty) | Token type | Escrow-based bounty with verifier arbitration. |
| [Credit Token](https://docs.bitbadges.io/agents/skills/credit-token) | Token type | Increment-only, non-transferable credit token purchased with any ICS20 denom. |
| [Crowdfund](https://docs.bitbadges.io/agents/skills/crowdfund) | Token type | On-chain crowdfunding with goal tracking via mustOwnTokens. |
| [Custom 2FA](https://docs.bitbadges.io/agents/skills/custom-2fa) | Token type | Two-factor authentication for transfers using a secondary approval address |
| [Fungible Token](https://docs.bitbadges.io/agents/skills/fungible-token) | Token type | Simple fungible token with fixed or unlimited supply and configurable mint/transfer approvals |
| [Liquidity Pools](https://docs.bitbadges.io/agents/skills/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](https://docs.bitbadges.io/agents/skills/nft-collection) | Token type | Non-fungible token collection with unique token IDs, metadata URIs, and badge-based ownership |
| [Payment obligations and reusable links](https://docs.bitbadges.io/agents/skills/payment-obligations) | Token type | Versioned invoice obligations, payer groups, installments, partial targets, split payouts and reusable payment links built from native approvals. |
| [Payment Protocol](https://docs.bitbadges.io/agents/skills/payment-protocol) | Token type | Invoices, escrows, bounties, milestones, and multi-party agreements using coinTransfer-based approvals or IBC-backed smart token escrow |
| [PaymentRequest](https://docs.bitbadges.io/agents/skills/payment-request) | Token type | Agent-initiated payment request with no escrow. |
| [Prediction Market](https://docs.bitbadges.io/agents/skills/prediction-market) | Token type | Binary prediction market with YES/NO outcome tokens, liquidity pool trading, and vote-based settlement |
| [Products](https://docs.bitbadges.io/agents/skills/product-catalog) | Token type | Multi-product storefront with per-product pricing, supply limits, and optional burn-on-purchase. |
| [Quest](https://docs.bitbadges.io/agents/skills/quest) | Token type | Quest/reward collection: users complete criteria and claim a badge + coin payout |
| [Smart Token](https://docs.bitbadges.io/agents/skills/smart-token) | Token type | IBC-backed smart token with 1:1 backing and two required approvals (backing + unbacking) |
| [Subscription](https://docs.bitbadges.io/agents/skills/subscription) | Token type | Time-based subscription token with recurring payment approvals and auto-deletion on expiry |
| [Tradable NFTs](https://docs.bitbadges.io/agents/skills/tradable) | Standard | NFT marketplace standard enabling peer-to-peer transfers with the "NFTMarketplace" standard tag and NFTPricingDenom |
| [Burnable](https://docs.bitbadges.io/agents/skills/burnable) | Approval | Allow token holders to burn tokens by sending them to the burn address, permanently removing them from circulation |
| [Minting](https://docs.bitbadges.io/agents/skills/minting) | Approval | Mint approval patterns including public mint, whitelist mint, creator-only mint, payment-gated mint, and escrow payouts |
| [Multi-Sig / Voting](https://docs.bitbadges.io/agents/skills/multi-sig-voting) | Approval | Require weighted quorum voting from multiple parties before transfers can proceed (multi-sig, governance, etc.) |
| [Auto-Mint](https://docs.bitbadges.io/agents/skills/auto-mint) | Feature | Mint and distribute tokens to recipients at collection creation time using MsgTransferTokens |
| [BB-402 Token-Gated Access](https://docs.bitbadges.io/agents/skills/bb-402) | Feature | Token-gated access protocol where ownership of specific badges grants API/resource access |
| [Transferability & Update Rules](https://docs.bitbadges.io/agents/skills/immutability) | Advanced | Lock collection permissions to make properties permanently immutable or permanently permitted |

## Related

- [MCP builder tools](https://docs.bitbadges.io/agents/mcp-tools)
- [Claude Code plugin](https://docs.bitbadges.io/agents/claude-code-plugin)