Skip to content

A skill, AGENTS.md and a plugin, so agents can use deed - #29

Merged
sepehr-safari merged 2 commits into
mainfrom
deed-for-agents
Sep 24, 2026
Merged

sepehr-safari merged 2 commits into
mainfrom
deed-for-agents

Conversation

@sepehr-safari

Copy link
Copy Markdown
Contributor

Closes #28.

  • skills/deed/SKILL.md, in the standard skill format: when to reach for deed, install, the rules an agent must follow (publishing is public and permanent, so ask the user first; the secret key stays in NOSTR_SECRET_KEY; key public takes a secret key), the stdout/stderr/exit-code contract, and recipes for keys, signing, verifying, publishing with a record of what went out, querying and keeping events, offline queries, NIP-19 and NIP-44. Every offline recipe was run against the binary before it went in.
  • .claude-plugin/: marketplace.json and plugin.json, so Claude Code installs it with /plugin marketplace add zig-nostr/deed and /plugin install deed@deed.
  • AGENTS.md, for changing deed: build, test, layout and the conventions that are easy to break (the record model, exit codes, untrusted relay text, the dial allocator in tests, cached test runs).
  • README: a section on using deed from an agent, with npx skills add zig-nostr/deed.

The last commit bumps the version to 0.3.2, which also carries #27 (a relay that pings and has stopped reading no longer holds req or fetch).

skills/deed/SKILL.md teaches an agent deed's commands, recipes that were each run against the binary, the output and exit-code contract, and two rules: publishing is public and permanent, so ask first, and keep a secret key in NOSTR_SECRET_KEY. It installs with npx skills add zig-nostr/deed, and .claude-plugin makes it a Claude Code plugin. AGENTS.md is for changing deed rather than using it. The README says how to add them.

Closes #28.
The agent skill and plugin, and req and fetch bounded against a relay that pings and has stopped reading.
@sepehr-safari
sepehr-safari merged commit 9a822de into main Sep 24, 2026
2 checks passed
@sepehr-safari
sepehr-safari deleted the deed-for-agents branch September 24, 2026 09:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

An agent has nothing written for it to learn deed from

1 participant