acrid-auto/skills/clawmart

SKILL.md - ClawMart Creator

Description

Create, manage, and publish ClawMart personas and skills, and download packages you own or purchased directly from OpenClaw chat.

Prerequisites

• ClawMart creator account with an active subscription
• API key generated in ClawMart dashboard (API Keys tab)
• Environment variable set: CLAWMART_API_KEY=cm_live_...

Setup

1. Generate a ClawMart API key in your dashboard.
2. Store the key as CLAWMART_API_KEY in environment/config.
3. Install this SKILL.md in your skills directory.

Commands

• "Create a skill on ClawMart for [description]"
• "Create a persona on ClawMart for [description]"
• "Search ClawMart listings for [use case]"
• "Update my [listing name] on ClawMart"
• "Upload a new version of [listing name]"
• "Show my ClawMart listings"
• "Download my [listing or purchase] from ClawMart"
• "Show my purchasable/downloadable ClawMart packages"

Workflow

1. Confirm which workflow is requested: creator management or purchased download.
2. Call GET /me first to validate identity/subscription.
3. For listing creation/update:
   • Brainstorm ideas with the user before writing metadata.
   • Draft metadata and confirm required fields: name, tagline, about, category, capabilities, price, product type.
   • Call POST /listings to create drafts and PATCH /listings/{id} to revise.
4. Generate high-quality package files from your own capabilities:
   • Persona packages: SOUL.md, MEMORY.md, and supporting docs.
   • Skill packages: a complete SKILL.md.
5. Upload files with POST /listings/{id}/versions.
6. For purchased/owned downloads:
   • Call GET /downloads to list accessible packages.
   • Resolve the best match by id/slug/name from that list.
   • Call GET /downloads/{idOrSlug} to fetch the package content.
7. Before any publish/delete action, ask for explicit user confirmation.
8. Summarize what was created/downloaded and provide next actions.

API Reference

• Base URL: <YOUR_CLAWMART_API_URL>
• Auth header: Authorization: Bearer ${CLAWMART_API_KEY}
• GET /me - creator profile and subscription state
• GET /listings - list creator listings
• GET /listings/search - search active listings by query (supports q, type, limit)
• POST /listings - create listing metadata
• PATCH /listings/{id} - update listing metadata
• DELETE /listings/{id} - unpublish/delete listing
• POST /listings/{id}/versions - upload package version (multipart or base64 JSON)
• GET /downloads - list all downloads you can access (created + purchased, including paid skills)
• GET /downloads/{idOrSlug} - download package content for an owned/purchased listing

Guardrails

• Never expose raw API keys in chat output.
• Require user confirmation before publishing changes.
• Validate payloads before each API call.
• Return clear errors with a suggested fix when requests fail.