← Back to Skills Marketplace
Nostr Nak
by
samthomson
· GitHub ↗
· v1.0.2
1083
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install nostr-nak
Description
General purpose skill for using the Nostr Army Knife (nak) CLI tool with PTY support.
Usage Guidance
This skill is an instruction-only helper for the 'nak' CLI and appears to do what it claims. Before installing/using: (1) ensure you trust the source — manifest metadata (homepage and tags) looks slightly off and the manifest version differs from the registry version; (2) make sure the 'nak' CLI is installed on your system — this skill only provides usage instructions; (3) avoid passing your nsec (private) key on the command line as shown in examples (command-line args can be seen by other processes and may be stored in shell history). Prefer using secure key storage (files with tight permissions, agent secret store, or prompting stdin), or other nak options that accept keys via files or stdin; (4) verify and be comfortable with the default relays the skill suggests; (5) if you need stronger assurance, run the agent/skill in a restricted environment or test with throwaway keys first.
Capability Analysis
Package: nostr-nak (xpi)
Version: 1.0.1
Description: Powerful Nostr integration using the nak CLI tool. Handles relay discovery, PTY buffering fixes, and provides examples for querying and posting.
The provided source code consists solely of metadata files (`_meta.json`, `manifest.json`) and a Markdown documentation file (`SKILL.md`). There is no executable code (e.g., JavaScript, Python, etc.) present to analyze for security vulnerabilities, malicious logic, or suspicious behavior. The documentation describes how to use an external CLI tool, 'nak', including details on relay logic, identity handling (private and public keys), and PTY requirements for command execution. Based on the provided files, the package itself contains no active components.
Capability Assessment
Purpose & Capability
The skill is an instruction-only helper for the 'nak' (Nostr Army Knife) CLI: relay defaults, PTY wrapper, and flag usage match the stated purpose. Minor metadata oddities exist in manifest.json (homepage points to an unrelated repo and tags include 'iot'), and the manifest version (1.0.1) doesn't match the registry version (1.0.2), but these do not contradict the core purpose.
Instruction Scope
SKILL.md stays on-topic (how to wrap 'nak' with a PTY, relay defaults, how to pass identities). It does instruct using nsec (private) keys or hex private keys on the nak command line, which is functional but is a security risk because command-line arguments can be exposed via process listings or shell history. The instructions do not direct the agent to read unrelated files, environment variables, or contact endpoints outside the listed relays.
Install Mechanism
No install spec and no bundled code — instruction-only. This minimizes risk because nothing is written or executed by the skill itself.
Credentials
The skill requests no environment variables or credentials (proportional). However, it explicitly advises passing private keys on the command line for posting, which is sensitive. The skill itself does not request or store secrets but its recommended usage can expose them if the user follows the example literally.
Persistence & Privilege
always is false and there is no install, so the skill does not request elevated persistence or system-wide changes. The skill can be invoked by the agent (default), which is expected for user-invocable skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nostr-nak - After installation, invoke the skill by name or use
/nostr-nak - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Minor SKILL.md refinements for clarity and conciseness.
- Simplified relay override instructions and usage examples.
- Added frontmatter with name and description for better documentation compatibility.
v1.0.1
- Updated manifest.json (details not specified).
- No user-facing documentation changes in SKILL.md.
v1.0.0
- Initial release of the nostr-nak skill for interacting with the Nostr Army Knife (nak) CLI tool.
- Added critical technical note: all nak commands must be wrapped in a PTY using script to avoid hangs.
- Default discovery relays (`wss://relay.damus.io`, `wss://relay.primal.net`, `wss://relay.nostr.band`) are used unless the user specifies their own.
- Supports identity handling for both querying (with npub/hex pubkey) and posting (with nsec/hex private key), with security precautions for secret keys.
- Provides clear usage examples for querying and posting notes.
- Includes a process for discovering unknown NIP or Kind numbers via the official NIPs repository or NostrHub, with clear verification instructions.
Metadata
Frequently Asked Questions
What is Nostr Nak?
General purpose skill for using the Nostr Army Knife (nak) CLI tool with PTY support. It is an AI Agent Skill for Claude Code / OpenClaw, with 1083 downloads so far.
How do I install Nostr Nak?
Run "/install nostr-nak" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nostr Nak free?
Yes, Nostr Nak is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Nostr Nak support?
Nostr Nak is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nostr Nak?
It is built and maintained by samthomson (@samthomson); the current version is v1.0.2.
More Skills