/SKILL.md
# Bitcoin Knowledge Base (BKB) Search across the Bitcoin and Lightning development ecosystem: BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs/commits, mailing lists, IRC logs, Delving Bitcoin, BitcoinTalk, and Optech newsletters. ## Setup for Claude (MCP) Install the `bkb-mcp` client and add it to your Claude Code MCP configuration (`~/.claude.json`): ```bash cargo install bkb-mcp ``` Add a `bkb` entry to the `mcpServers` object in `~/.claude.json`: ```json { "mcpServers": { "bkb":
npx skillsauth add tnull/bitcoin-knowledge-base bitcoin-knowledge-baseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Search across the Bitcoin and Lightning development ecosystem: BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs/commits, mailing lists, IRC logs, Delving Bitcoin, BitcoinTalk, and Optech newsletters.
Install the bkb-mcp client and add it to your Claude Code MCP
configuration (~/.claude.json):
cargo install bkb-mcp
Add a bkb entry to the mcpServers object in ~/.claude.json:
{
"mcpServers": {
"bkb": {
"type": "stdio",
"command": "bkb-mcp",
"args": [],
"env": {
"BKB_API_URL": "https://bitcoinknowledge.dev"
}
}
}
}
Or via CLI command:
claude mcp add -t stdio -s user bkb bkb-mcp -e BKB_API_URL="https://bitcoinknowledge.dev"
Create a Custom GPT and add an Action with the following schema URL:
https://bitcoinknowledge.dev/openapi.json
ChatGPT will automatically discover all available endpoints from the OpenAPI spec.
bkb_search -- Full-text search across all sources (filters: source_type, source_repo, author, after, before, limit). Supports wildcard queries: use query: "*" with at least one filter to retrieve all documents matching the filters (e.g., all commits in a repo within a date range).bkb_get_document -- Get full document by ID with content, cross-references, and concept tagsbkb_get_references -- Find all documents referencing an entity (e.g. BIP-340, bitcoin/bitcoin#12345)bkb_lookup_bip -- BIP spec with all referencing discussions and PRsbkb_lookup_bolt -- BOLT spec with all referencing documentsbkb_lookup_blip -- bLIP spec with all referencing documentsbkb_lookup_lud -- LUD spec with all referencing documentsbkb_lookup_nut -- NUT spec with all referencing documentsbkb_timeline -- Chronological timeline of a concept across all sourcesbkb_find_commit -- Find commits/PRs matching a descriptiontools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.