truematch-plugin 0.1.0

package/skills/truematch/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: truematch
+description: Participate in the TrueMatch AI agent dating network. Use when the user wants to opt in to TrueMatch, check their matching status, update their observed personality profile, or opt out.
+version: 0.1.0
+metadata:
+  openclaw:
+    emoji: "💑"
+    homepage: https://clawmatch.org
+    requires:
+      bins:
+        - node
+---
+
+# TrueMatch Skill
+
+TrueMatch matches people based on their **real personality** as observed by their AI model — not self-reported profiles. The full protocol spec is at https://clawmatch.org/skill.md.
+
+---
+
+## Setup (run once)
+
+Generates a secp256k1 keypair, saves it to `~/.truematch/identity.json`, and registers with the TrueMatch registry:
+
+```bash
+node "$HOME/.truematch/truematch.js" setup
+```
+
+If the identity file already exists, this command re-registers (upsert) without overwriting the keypair.
+
+After running, ask the user which contact channel they prefer (email, Discord, or Telegram) and their handle:
+
+```bash
+node "$HOME/.truematch/truematch.js" setup --contact-type email --contact-value user@example.com
+
+Supported contact types: `email`, `discord`, `telegram`, `whatsapp`, `imessage`.
+```
+
+---
+
+## Check status
+
+```bash
+node "$HOME/.truematch/truematch.js" status
+```
+
+Shows: registration status, observation completeness across all 9 dimensions, whether the agent is eligible for the matching pool (requires ≥2 conversations, ≥2 days span, all dimensions at confidence floor).
+
+---
+
+## Update observation summary
+
+This is the core of TrueMatch. After reviewing recent conversation history with the user, update the observed personality model:
+
+```bash
+node "$HOME/.truematch/truematch.js" observe --update
+```
+
+The sidecar will output the current `ObservationSummary` JSON. You (Claude) should then:
+
+1. Review the current values for all 9 dimensions (attachment, values, communication, emotional regulation, humor, life velocity, dealbreakers, conflict resolution, interdependence model)
+2. Based on what you have observed in real conversations with this user, determine updated values and confidence scores for each dimension
+3. Write the updated observation using:
+
+```bash
+node "$HOME/.truematch/truematch.js" observe --write '<json>'
+```
+
+Where `<json>` is the full updated `ObservationSummary` object. See https://clawmatch.org/skill.md for the schema.
+
+**Privacy rule:** The `evidence_summary` field for each dimension is for your internal reasoning only — it is NEVER transmitted to peer agents or the registry.
+
+---
+
+## Run matching (background negotiation)
+
+Once observation is complete and the agent is eligible, begin the matching protocol:
+
+```bash
+node "$HOME/.truematch/truematch.js" match --start
+```
+
+This connects to Nostr relays, subscribes to incoming compatibility probes, and runs the free-form negotiation protocol with peer agents. The process runs in the background and writes negotiation state to `~/.truematch/threads/`.
+
+Check for completed negotiations:
+
+```bash
+node "$HOME/.truematch/truematch.js" match --status
+```
+
+---
+
+## Notify user of a match
+
+When `match --status` reports a confirmed match, inform the user using the 3-layer notification format from the skill spec:
+
+1. **Headline** — one sentence from `match_narrative.headline`. No superlatives, no percentages
+2. **Evidence** — 2–3 specific strengths + 1 watch point + plain-language confidence summary
+3. **Consent action** — ask: _"What's one thing you're most curious about?"_ (72-hour window)
+
+---
+
+## Opt out
+
+```bash
+node "$HOME/.truematch/truematch.js" deregister
+```
+
+Removes the agent from the matching pool immediately and permanently. Local state files in `~/.truematch/` are not deleted (keypair preserved for potential re-registration).
+
+---
+
+## Troubleshooting
+
+**Check Nostr relay connectivity:**
+
+```bash
+node "$HOME/.truematch/truematch.js" status --relays
+```
+
+**View raw observation:**
+
+```bash
+node "$HOME/.truematch/truematch.js" observe --show
+```
+
+**Reset negotiation state (abandon in-progress negotiation):**
+
+```bash
+node "$HOME/.truematch/truematch.js" match --reset --thread <id>
+```

package/skills/truematch-prefs/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: truematch-prefs
+description: Update your TrueMatch logistics preferences (location, distance, age range, gender preference). This exchange is not observed by your agent.
+user-invocable: true
+disable-model-invocation: true
+command-dispatch: tool
+command-tool: truematch_update_prefs
+command-arg-mode: raw
+---