[Feature]: Publish PowerMem setup skill to skills.sh and ClawHub for one-click agent onboarding

[longdafeng]

Summary

Publish a PowerMem quick-setup Agent Skill to public skill distribution platforms — primarily skills.sh and ClawHub — so users can install PowerMem with one command and let their AI agent wire up memory automatically.

Related: #942

Motivation

PowerMem already ships first-party integration guides that work when pasted into an agent chat:

Read and follow apps/claude-code-plugin/SETUP.md to set up PowerMem memory for Claude Code.

Read and follow apps/vscode-extension/SETUP.md to setup PowerMem

Read and follow apps/mcp-client/SETUP.md to setup PowerMem

However, new users still need to find the repo, clone it, and know which prompt to paste. Publishing an official skill to skill marketplaces would reduce time-to-first-value from "read docs + configure" to "install skill → agent runs setup".

Target platforms:

Platform	URL	Notes
skills.sh	https://skills.sh	Primary Agent Skills distribution hub (Agent Skills open standard)
ClawHub	https://clawhub.ai/	Community skill/plugin registry (OpenClaw ecosystem)
(optional) agentskill.sh	https://agentskill.sh	Cross-platform install via ags CLI

Existing assets in this repo

We already have skill-like building blocks that can be packaged:

Claude Code plugin skills (apps/claude-code-plugin/skills/):

Skill	Purpose
init	Initialize PowerMem backend after plugin install
remember	Add/update a memory
recall	Search memories before answering
status	Check config, server health, connectivity
reset / stop	Lifecycle management

Agent-readable setup prompts:

• apps/claude-code-plugin/SETUP.md — Claude Code end-to-end setup
• apps/vscode-extension/SETUP.md — Cursor / VS Code / Qoder / CodeFuse
• apps/mcp-client/SETUP.md — Any MCP client (Codex, Cline, OpenCode, etc.)

Backend entry points:

• pip install powermem + powermem-server (HTTP API, default :8848)
• powermem-mcp sse (MCP server)
• MCP tools: add_memory, search_memories, update_memory, delete_memory, etc.

Proposal

1. Author a standalone "setup-powermem" Agent Skill

Create a portable skill directory (e.g. skills/setup-powermem/ or publish from apps/claude-code-plugin/skills/init/) conforming to the Agent Skills spec:

---
name: setup-powermem
description: >
  Install and configure PowerMem persistent memory for AI agents.
  Use when the user wants to set up, initialize, or enable long-term memory
  in Cursor, Claude Code, VS Code, or any MCP client.
version: 0.1.0
---

The skill should:

1. Detect the current agent platform (Cursor → .cursor/skills/, Claude Code → plugin/marketplace, Copilot → .github/copilot/skills/, etc.)
2. Boot or connect to a PowerMem backend with sensible defaults (pip install powermem, managed powermem-server, reuse existing instance when healthy)
3. Wire MCP / HTTP endpoints into the agent's config automatically
4. Collect only missing secrets (LLM provider, API key) via env vars — never print keys
5. Embed usage guidance — when to add_memory vs search_memories, user_id/agent_id conventions
6. Support China network — optional ModelScope preload for embedding model (see POWERMEM_INIT_PRELOAD_MODEL=1 in init scripts)

2. Publish to skills.sh

• Ensure public GitHub repo path + valid SKILL.md frontmatter (name, description, version)

• Submit via npx skills publish (or current skills.sh CLI workflow)

• Add install one-liner to README, e.g.:

  npx skills install oceanbase/powermem/setup-powermem

3. Publish to ClawHub

• Package as a ClawHub Skill (agent skill bundle) targeting OpenClaw + generic agent users
• Cross-link with existing memory-powermem OpenClaw plugin where appropriate
• Follow ClawHub publish flow: https://clawhub.ai/ → Publish Skill

4. Documentation & discoverability

• Add a "Install via Skill Marketplace" section to README (EN + CN)

• Provide platform-specific install snippets:

  # skills.sh (Cursor example)
  npx skills install oceanbase/powermem/setup-powermem --cursor
  
  # agentskill.sh
  ags install @oceanbase/setup-powermem --cursor

• Record a short end-to-end demo: install skill → agent initializes PowerMem → agent remembers/recalls a fact across sessions

Acceptance criteria

• Standalone setup-powermem skill exists in repo with Agent Skills–compliant SKILL.md and bundled scripts/references
• Skill published and listed on skills.sh
• Skill published and listed on ClawHub
• README updated with marketplace install instructions (linking both platforms)
• Verified on at least Cursor and Claude Code — agent completes setup without manual doc reading
• End-to-end demo doc or recording attached

Why this matters

• Compresses multi-step integration into a single skill install
• Drives discoverability through skill marketplace search ("memory", "persistent context", "agent memory")
• Complements zero-config efforts (Too many config options — simplify toward zero-config startup, plus split .env.example into minimal vs. full #940, Support a built-in default embedding model for true zero-config startup (especially in powermem-ts) #941) and the broader ecosystem push in Author a skill for one-click powermem startup and AI-agent integration, and publish it to the skill marketplace #942
• Aligns with PowerMem's positioning: "pick your client, copy one line" — but now that line is npx skills install ...