nostr-core

Appearance

Agent Skills (Claude Code Plugin) ​

nostr-core ships as a Claude Code plugin with 10 agent skills that teach AI agents how to build Lightning-enabled applications. Skills can be invoked manually via slash commands or auto-detected by Claude based on context.

Installing the Plugin ​

From GitHub ​

/plugin install nostr-core-org/nostr-core

From a local clone ​

If you've cloned the repository, the skills are available automatically when you open the project in Claude Code.

For your team ​

Add to your project's .claude/settings.json:

json
{
  "enabledPlugins": {
    "nostr-core": true
  }
}

Available Skills ​

Find the right specification, repository, or resource for any Nostr feature. This skill acts as a compass for the protocol ecosystem -- it points you to the correct NIPs, LNURL LUDs, Cashu NUTs, Blossom BUDs, and maps each to the corresponding nostr-core module. Covers:

  • Nostr protocol NIPs -- how to find and read them, look up event kinds
  • LNURL protocol (LUD specs) and Lightning Address
  • BOLT-11 invoice format
  • NWC / NIP-47 wallet connection
  • eCash / Cashu (NIP-60 + NUT specs)
  • Blossom media storage (BUD specs)
  • Encryption guidance (NIP-04 vs NIP-44)
  • Full module map linking every nostr-core module to its spec
/navigate-nostr

/nostr-identity - Nostr Identity Management ​

Generate and manage Nostr identities. Covers:

  • Keypair generation (generateSecretKey, getPublicKey)
  • BIP-39 mnemonic derivation (NIP-06)
  • NIP-05 DNS verification (queryNip05, verifyNip05)
  • Unified Signer interface (secret key, NIP-07 browser extension, NIP-46 remote signer)
  • Bech32 encoding/decoding (npub, nsec, nevent, nprofile)
  • Profile publishing (kind 0)
/nostr-identity keys
/nostr-identity mnemonic
/nostr-identity nip05
/nostr-identity signer
/nostr-identity nip46

/nostr-messaging - Nostr Communication ​

Send and receive messages on the Nostr network. Covers:

  • Private DMs with gift wrap (NIP-17) -- sender metadata hidden from relays
  • Public notes (kind 1) with thread replies (NIP-10) and reactions (NIP-25)
  • Public chat channels (NIP-28) -- create, post, read
  • Relay-based groups (NIP-29) -- group chat and metadata
  • Real-time subscriptions with Relay and RelayPool
/nostr-messaging dm
/nostr-messaging note
/nostr-messaging channel
/nostr-messaging group
/nostr-messaging listen

/nostr-social - Social Features ​

Build social interactions on Nostr. Covers:

  • Threaded replies (NIP-10) -- parse and build thread references
  • Reactions (NIP-25) -- like, dislike, custom emoji
  • Reposts (NIP-18) -- text and generic reposts
  • Long-form articles (NIP-23) -- publish and parse
  • Comments (NIP-22) -- comment on events, URLs, or any content
  • Follow lists (NIP-02) -- manage contacts
  • Lists and bookmarks (NIP-51) -- public and encrypted private items
  • Badges (NIP-58) -- define, award, check status
  • Calendar events (NIP-52) -- date-based, time-based, RSVP
  • Zaps and zap goals (NIP-57, NIP-75) -- Lightning-powered reactions
  • Content moderation (NIP-36, NIP-56, NIP-09, NIP-40)
  • Custom emoji (NIP-30)
/nostr-social threads
/nostr-social reactions
/nostr-social articles
/nostr-social follows
/nostr-social badges
/nostr-social zaps
/nostr-social calendar
/nostr-social moderation

/lnbits-mcp - LNbits Wallet + MCP Integration ​

Connect nostr-core to a LNbits Lightning wallet and set up the LNbits MCP Server. Covers:

  • Getting an NWC connection string from the LNbits NWC extension
  • Connecting and verifying capabilities
  • Basic wallet operations (balance, invoices, payments, notifications)
  • Error handling with typed errors
  • LNbits MCP Server installation and setup (30+ tools)
  • Claude Desktop configuration for conversational wallet control
/lnbits-mcp connect
/lnbits-mcp mcp
/lnbits-mcp full

/nwc-integrate - NWC Wallet Integration ​

Set up a project with nostr-core and connect to any NWC-compatible Lightning wallet. Covers:

  • Package installation and ESM configuration
  • Connection string handling and security
  • Connect/operate/close lifecycle
  • Capability detection via getInfo()
  • Error handling scaffold with typed errors
  • TypeScript types for full type safety
/nwc-integrate payment bot for my Discord server

/lightning-pay - Lightning Payments ​

Execute all types of Lightning payments. Covers:

  • Pay BOLT-11 invoices (payInvoice)
  • Pay Lightning Addresses in sats (payLightningAddress)
  • Pay Lightning Addresses in fiat (payLightningAddressFiat)
  • Keysend payments with TLV records (payKeysend)
  • Pre-payment balance and budget checks
  • User confirmation patterns
  • Payment error handling
/lightning-pay lnbc10u1pj...
/lightning-pay hello@getalby.com 100 sats

/wallet-monitor - Wallet Monitoring & Analytics ​

Monitor wallet activity and analyze transaction history. Covers:

  • Create invoices for receiving payments (makeInvoice)
  • Check invoice status (lookupInvoice)
  • Query and filter transaction history (listTransactions)
  • Real-time payment notifications (event emitter + subscription patterns)
  • Message signing (signMessage)
  • Analytics patterns (daily summaries, fiat conversion, payment frequency)
/wallet-monitor listen
/wallet-monitor history last 7 days
/wallet-monitor create-invoice 1000 sats

/lightning-agent - Complete Agent Scaffold ​

Copy-paste a ready-made LightningAgent class that combines wallet, messaging, and identity. Covers:

  • Minimal wallet-only agent (balance, invoices, payments, Lightning Address)
  • Full agent with wallet + DMs + notes + profile management
  • Fiat-denominated payments
  • Payment notification listeners
  • Error handling scaffold
  • Extension points (budget guards, threads, reactions, zaps)
/lightning-agent full
/lightning-agent wallet-only
/lightning-agent minimal

/nostr-primitives - Nostr Protocol Building Blocks ​

Comprehensive Nostr protocol toolkit (39 NIPs) for custom application development. Covers:

  • Key generation, management, and BIP-39 mnemonic derivation (NIP-06)
  • Event creation, signing, and verification
  • Unified Signer interface (createSecretKeySigner, Nip07Signer, NostrConnect)
  • Browser extension signing (NIP-07) via window.nostr
  • Remote signing (NIP-46) via Nostr Connect
  • Relay connections (single + pool), relay info (NIP-11), relay auth (NIP-42)
  • NIP-04 and NIP-44 encryption
  • NIP-59 gift wrapping (multi-layer metadata protection)
  • NIP-65 relay list metadata (user relay preferences for read/write routing)
  • NIP-17 private direct messages (end-to-end encrypted DMs)
  • NIP-19 bech32 encoding/decoding, NIP-21 nostr: URI scheme
  • Follow list / contact list (NIP-02)
  • DNS-based verification (NIP-05)
  • Event deletion (NIP-09), reactions (NIP-25), threads (NIP-10)
  • Proof of work (NIP-13), reposts (NIP-18)
  • Comments (NIP-22), long-form content (NIP-23), extra metadata (NIP-24)
  • Text note references (NIP-27), public chat channels (NIP-28), custom emoji (NIP-30), alt tags (NIP-31)
  • Content warnings (NIP-36), expiration timestamps (NIP-40)
  • Proxy tags for bridged events (NIP-48), search (NIP-50)
  • Lists with encrypted private items (NIP-51)
  • Reporting (NIP-56), Lightning zaps (NIP-57), badges (NIP-58)
  • Calendar events, calendars, RSVP (NIP-52)
  • Relay-based groups (NIP-29)
  • Zap goals with beneficiaries (NIP-75)
  • HTTP authentication (NIP-98)
  • LNURL protocol (LUD-01/03/06/09/10/12/17/18/20/21) - encoding, pay requests, withdraw requests, success actions
  • Event filtering and matching
  • NWC protocol internals
/nostr-primitives keys
/nostr-primitives encryption
/nostr-primitives giftwrap
/nostr-primitives relaylist
/nostr-primitives dm
/nostr-primitives relays
/nostr-primitives signer
/nostr-primitives nip07
/nostr-primitives nip46
/nostr-primitives deletion
/nostr-primitives threads
/nostr-primitives reactions
/nostr-primitives comments
/nostr-primitives articles
/nostr-primitives lists
/nostr-primitives zaps
/nostr-primitives badges
/nostr-primitives groups
/nostr-primitives dns
/nostr-primitives auth
/nostr-primitives emoji
/nostr-primitives uri
/nostr-primitives follows
/nostr-primitives pow
/nostr-primitives repost
/nostr-primitives channels
/nostr-primitives content-warning
/nostr-primitives expiration
/nostr-primitives proxy
/nostr-primitives search
/nostr-primitives report
/nostr-primitives calendars
/nostr-primitives zapgoals
/nostr-primitives lnurl
/nostr-primitives lnurl-pay
/nostr-primitives lnurl-withdraw

How Skills Work ​

Automatic invocation: Claude reads the skill descriptions and loads them automatically when relevant. For example, if you ask "help me connect to a Lightning wallet", Claude will load the nwc-integrate skill.

Manual invocation: Type /skill-name followed by optional arguments:

/lightning-pay send 500 sats to hello@getalby.com

Skill chaining: Skills build on each other. Start with /navigate-nostr to find the right specs and modules. Use /nostr-identity to create a keypair, /lnbits-mcp to connect a wallet, /lightning-pay or /wallet-monitor for payment operations, /nostr-messaging for communication, and /nostr-social for social features. Use /lightning-agent to scaffold a complete agent class. Use /nwc-integrate for generic NWC setup beyond LNbits. Use /nostr-primitives for low-level protocol access.

Publishing Your Own Marketplace ​

To distribute these skills via a marketplace:

  1. Fork or reference the nostr-core-org/nostr-core repository
  2. Users add it with: /plugin install nostr-core-org/nostr-core
  3. Or create a marketplace marketplace.json that includes this plugin

See the Claude Code plugin docs for details.

Released under the MIT License.