Merge pull request #1 from ProjectOpenSea/feat/migrate-to-clawhub

feat: attach opensea skill via ClawHub instead of submodule

Author: ryanio

.gitmodules

@@ -21,7 +21,7 @@ Supported chains: see `workspace/TOOLS.md`. Mainnets only by default.
 ## What's bundled
 
 - [`@opensea/cli`](https://github.com/ProjectOpenSea/opensea-cli) — installed globally at build time.
-- [`ProjectOpenSea/opensea-skill`](https://github.com/ProjectOpenSea/opensea-skill) at `skills/opensea/` (git submodule, pinned to `v2.1.0`) — SKILL.md + 7 reference docs + shell scripts for Seaport, swaps, stream events, wallet setup, and policy templates.
+- [`opensea/opensea-marketplace`](https://clawhub.ai/opensea/opensea-marketplace) — attached via `manifest.json` → `skills` and mounted at `skills/opensea/`. SKILL.md + reference docs + shell scripts for Seaport, swaps, stream events, wallet setup, and policy templates. Pinata pulls the latest published version at deploy time.
 
 ## Secrets you'll need
 
@@ -74,29 +74,22 @@ Full walkthrough: `skills/opensea/references/wallet-setup.md`. Policy templates:
 
 ```
 .
-├── manifest.json              # Pinata agent manifest
-├── setup.sh                   # build: submodule init + CLI install
+├── manifest.json              # Pinata agent manifest — attaches opensea/opensea-marketplace from ClawHub
 ├── .openclaw/
 │   ├── openclaw.json
 │   └── SOUL.md                # short canonical persona — points at workspace/SOUL.md
-├── workspace/
-│   ├── SOUL.md                # guardrails + Conviction Score + Pre-Buy Gate
-│   ├── AGENTS.md              # workspace conventions + memory schemas
-│   ├── IDENTITY.md            # blank — filled on first run
-│   ├── TOOLS.md               # watchlist, whales, budgets — user-tunable
-│   ├── BOOTSTRAP.md           # first-run walkthrough
-│   ├── HEARTBEAT.md           # idle-cycle routine
-│   └── USER.md                # collector profile — filled on first run
-└── skills/opensea/            # submodule: opensea-skill @ v2.1.0
-    ├── SKILL.md
-    ├── references/*.md        # rest-api, seaport, wallet-setup, wallet-policies, …
-    └── scripts/*.sh           # opensea-fulfill-listing.sh, opensea-stream-collection.sh, …
+└── workspace/
+    ├── SOUL.md                # guardrails + Conviction Score + Pre-Buy Gate
+    ├── AGENTS.md              # workspace conventions + memory schemas
+    ├── IDENTITY.md            # blank — filled on first run
+    ├── TOOLS.md               # watchlist, whales, budgets — user-tunable
+    ├── BOOTSTRAP.md           # first-run walkthrough
+    ├── HEARTBEAT.md           # idle-cycle routine
+    └── USER.md                # collector profile — filled on first run
 ```
 
+At deploy time Pinata attaches the OpenSea skill under `skills/opensea/` (SKILL.md + `references/*.md` + `scripts/*.sh`) — not checked into this repo.
+
 ## Updating the skill
 
-```bash
-git -C skills/opensea fetch --tags
-git -C skills/opensea checkout v2.2.0   # or whichever tag you want
-git add skills/opensea && git commit -m "chore: bump opensea-skill to v2.2.0"
-```
+Skill versions are managed on ClawHub, not in this template. To pick up a new version, no repo change is needed — Pinata pulls the latest published version of `opensea/opensea-marketplace` on each deploy. To pin to a specific version, replace `clawhub_slug` in `manifest.json` with a `cid` for that version.

README.md

@@ -14,8 +14,11 @@
     "authorUrl": "https://github.com/ProjectOpenSea/opensea-skill",
     "authorLogoUrl": "https://static.seadn.io/logos/Logomark-Blue.png"
   },
+  "skills": [
+    { "clawhub_slug": "opensea/opensea-marketplace", "name": "OpenSea" }
+  ],
   "scripts": {
-    "build": "bash setup.sh",
+    "build": "npm install -g @opensea/cli",
     "start": ""
   },
   "routes": []

manifest.json

@@ -13,7 +13,7 @@ workspace/
   USER.md           # About your human (filled on first run)
   MEMORY.md         # Long-running free-text observations (create when useful)
   memory/           # Structured memory files (create on first write)
-skills/opensea/     # Skill submodule, pinned to v2.1.0
+skills/opensea/     # Attached from ClawHub at deploy time (opensea/opensea-marketplace)
 ```
 
 ## Memory Schemas
@@ -63,11 +63,11 @@ Free-text long-form observations that don't fit a schema: API quirks, volatile s
 
 - **You (the agent)** write to: `memory/*`, `workspace/MEMORY.md`, `workspace/IDENTITY.md`, `workspace/USER.md`, and once — to delete `workspace/BOOTSTRAP.md` after first-run.
 - **User** writes to: `workspace/TOOLS.md`. When they edit it, re-read at the start of the next turn.
-- **Never write** to: `skills/opensea/` (read-only submodule), `manifest.json`, `setup.sh`, `.openclaw/*`, `README.md`.
+- **Never write** to: `skills/opensea/` (read-only, attached from ClawHub), `manifest.json`, `.openclaw/*`, `README.md`.
 
 ## Workflow
 
-1. **Build** runs automatically after each `git push` (submodule init + `@opensea/cli` install — see `setup.sh`).
+1. **Build** runs automatically after each `git push` — installs `@opensea/cli` globally (see `manifest.json` → `scripts.build`). The OpenSea skill is attached separately by Pinata from ClawHub.
 2. **Start** is a no-op — the agent operates via conversation and heartbeat, not a web server.
 
 ## Safety

setup.sh

@@ -5,7 +5,7 @@ _User-tunable. Edit this file to change what the agent watches, who it follows,
 ## Stack
 
 - **OpenSea CLI:** `@opensea/cli` — installed globally at build time. Use `opensea --help` for the command tree.
-- **OpenSea skill:** `skills/opensea/` — git submodule pinned to `v2.1.0`.
+- **OpenSea skill:** `skills/opensea/` — attached from ClawHub (`opensea/opensea-marketplace`) at deploy time.
 - **Wallet:** Privy server wallet, env-configured (`PRIVY_APP_ID`, `PRIVY_APP_SECRET`, `PRIVY_WALLET_ID`).
 
 ## Watchlist