feat: add mempool.space public api skill

docs/skills.md

@@ -51,6 +51,8 @@ This repository ships one canonical skill for UXC (Universal X-Protocol CLI) and
   - Wrapper for Hive Intelligence official remote MCP workflows via UXC as a broad crypto discovery and convenience layer.
 - `skills/nodit-openapi-skill`
   - Wrapper for Nodit Web3 Data API entity, account, and token reads via UXC + curated OpenAPI schema and API-key auth.
+- `skills/mempool-space-openapi-skill`
+  - Wrapper for mempool.space public Bitcoin fee, mempool, address, transaction, and Lightning explorer reads via UXC + curated OpenAPI schema.
 - `skills/alchemy-openapi-skill`
   - Wrapper for Alchemy Prices API read workflows via UXC + curated OpenAPI schema and path-templated API-key auth.
 - `skills/chainbase-openapi-skill`
@@ -95,7 +97,7 @@ python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github
   --path skills/deepwiki-mcp-skill
 ```
 
-Replace `skills/deepwiki-mcp-skill` with `skills/context7-mcp-skill`, `skills/okx-mcp-skill`, `skills/dune-mcp-skill`, `skills/thegraph-mcp-skill`, `skills/thegraph-token-mcp-skill`, `skills/etherscan-mcp-skill`, `skills/notion-mcp-skill`, `skills/discord-openapi-skill`, `skills/slack-openapi-skill`, `skills/matrix-openapi-skill`, `skills/line-openapi-skill`, `skills/feishu-openapi-skill`, `skills/whatsapp-openapi-skill`, `skills/dingtalk-openapi-skill`, `skills/coingecko-openapi-skill`, `skills/defillama-openapi-skill`, `skills/blockscout-openapi-skill`, `skills/chainbase-openapi-skill`, `skills/moralis-openapi-skill`, `skills/alchemy-openapi-skill`, `skills/coinapi-openapi-skill`, `skills/dexscreener-openapi-skill`, `skills/helius-openapi-skill`, `skills/blocknative-openapi-skill`, `skills/near-jsonrpc-skill`, `skills/hive-mcp-skill`, `skills/nodit-openapi-skill`, `skills/binance-web3-openapi-skill`, or `skills/binance-spot-openapi-skill` as needed.
+Replace `skills/deepwiki-mcp-skill` with `skills/context7-mcp-skill`, `skills/okx-mcp-skill`, `skills/dune-mcp-skill`, `skills/thegraph-mcp-skill`, `skills/thegraph-token-mcp-skill`, `skills/etherscan-mcp-skill`, `skills/notion-mcp-skill`, `skills/discord-openapi-skill`, `skills/slack-openapi-skill`, `skills/matrix-openapi-skill`, `skills/line-openapi-skill`, `skills/feishu-openapi-skill`, `skills/whatsapp-openapi-skill`, `skills/dingtalk-openapi-skill`, `skills/coingecko-openapi-skill`, `skills/defillama-openapi-skill`, `skills/blockscout-openapi-skill`, `skills/chainbase-openapi-skill`, `skills/moralis-openapi-skill`, `skills/alchemy-openapi-skill`, `skills/coinapi-openapi-skill`, `skills/dexscreener-openapi-skill`, `skills/helius-openapi-skill`, `skills/blocknative-openapi-skill`, `skills/near-jsonrpc-skill`, `skills/hive-mcp-skill`, `skills/nodit-openapi-skill`, `skills/mempool-space-openapi-skill`, `skills/binance-web3-openapi-skill`, or `skills/binance-spot-openapi-skill` as needed.
 
 After installation, restart Codex to load new skills.
 
@@ -232,6 +234,12 @@ bash skills/hive-mcp-skill/scripts/validate.sh
 bash skills/nodit-openapi-skill/scripts/validate.sh
 ```
 
+- Validate mempool.space wrapper docs when touched:
+
+```bash
+bash skills/mempool-space-openapi-skill/scripts/validate.sh
+```
+
 - Validate Alchemy wrapper docs when touched:
 
 ```bash

skills/mempool-space-openapi-skill/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: mempool-space-openapi-skill
+description: Operate mempool.space public Bitcoin and Lightning explorer APIs through UXC with a curated OpenAPI schema, no-auth setup, and read-first guardrails.
+---
+
+# mempool.space API Skill
+
+Use this skill to run mempool.space public Bitcoin and Lightning explorer operations through `uxc` + OpenAPI.
+
+Reuse the `uxc` skill for shared execution, auth, and error-handling guidance.
+
+## Prerequisites
+
+- `uxc` is installed and available in `PATH`.
+- Network access to `https://mempool.space/api`.
+- Access to the curated OpenAPI schema URL:
+  - `https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json`
+
+## Scope
+
+This skill covers a read-first mempool.space surface for:
+
+- Bitcoin fee estimation and mempool state reads
+- block tip height checks
+- address and transaction status reads
+- Lightning network search, statistics, node rankings, node detail, and channel reads
+
+This skill does **not** cover:
+
+- transaction broadcast or package submission
+- websocket subscriptions
+- internal or admin routes
+- every Esplora-compatible endpoint exposed by mempool.space
+
+## Authentication
+
+mempool.space public reads in this skill do not require authentication.
+
+## Core Workflow
+
+1. Use the fixed link command by default:
+   - `command -v mempool-space-openapi-cli`
+   - If missing, create it:
+     `uxc link mempool-space-openapi-cli https://mempool.space/api --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json`
+   - `mempool-space-openapi-cli -h`
+
+2. Inspect operation schema first:
+   - `mempool-space-openapi-cli get:/v1/fees/recommended -h`
+   - `mempool-space-openapi-cli get:/mempool -h`
+   - `mempool-space-openapi-cli get:/address/{address} -h`
+   - `mempool-space-openapi-cli get:/v1/lightning/search -h`
+   - `mempool-space-openapi-cli get:/v1/lightning/channels/{short_id} -h`
+
+3. Prefer narrow reads before broader scans:
+   - `mempool-space-openapi-cli get:/v1/fees/recommended`
+   - `mempool-space-openapi-cli get:/blocks/tip/height`
+   - `mempool-space-openapi-cli get:/v1/lightning/statistics/latest`
+
+4. Execute with key/value parameters:
+   - `mempool-space-openapi-cli get:/address/{address} address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`
+   - `mempool-space-openapi-cli get:/tx/{txid}/status txid=4d5d7f2d5dc69aa68a51887db07dd6d906f31f9141320f9f0b4bab76d735a47f`
+   - `mempool-space-openapi-cli get:/v1/lightning/search searchText=bfx`
+   - `mempool-space-openapi-cli get:/v1/lightning/channels public_key=033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025 status=active`
+   - `mempool-space-openapi-cli get:/v1/lightning/channels/{short_id} short_id=835866331763769345`
+
+## Operations
+
+- `get:/v1/fees/recommended`
+- `get:/mempool`
+- `get:/blocks/tip/height`
+- `get:/address/{address}`
+- `get:/tx/{txid}/status`
+- `get:/v1/lightning/statistics/latest`
+- `get:/v1/lightning/search`
+- `get:/v1/lightning/nodes/rankings`
+- `get:/v1/lightning/nodes/{public_key}`
+- `get:/v1/lightning/channels`
+- `get:/v1/lightning/channels/{short_id}`
+
+## Guardrails
+
+- Keep automation on the JSON output envelope; do not use `--text`.
+- Parse stable fields first: `ok`, `kind`, `protocol`, `data`, `error`.
+- Treat this v1 skill as read-only. Do not use `tx/push`, package submission, or internal routes.
+- Prefer the curated fee, mempool, and Lightning reads here before dropping to the much larger generic Esplora surface.
+- `mempool.space` is a public explorer service, so mempool state and Lightning rankings can move quickly. Re-query instead of assuming cached values remain current.
+- For `get:/v1/lightning/channels/{short_id}`, mempool.space currently accepts the channel `id` string even though the route label says `short_id`; prefer values returned by search or node channel listing.
+- `mempool-space-openapi-cli <operation> ...` is equivalent to `uxc https://mempool.space/api --schema-url <mempool_space_openapi_schema> <operation> ...`.
+
+## References
+
+- Usage patterns: `references/usage-patterns.md`
+- Curated OpenAPI schema: `references/mempool-space-public.openapi.json`
+- Official mempool repository: https://github.com/mempool/mempool

skills/mempool-space-openapi-skill/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "mempool.space Public API"
+  short_description: "Operate mempool.space Bitcoin fee, mempool, address, transaction, and Lightning explorer reads via UXC + curated OpenAPI schema"
+  default_prompt: "Use $mempool-space-openapi-skill to discover and execute mempool.space public Bitcoin and Lightning read-only operations through UXC with public no-auth access and explorer-focused guardrails."