diff --git a/CLAUDE.md b/CLAUDE.md index 0c0b114..fb145ee 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -164,6 +164,17 @@ See domain-specific roadmaps in each skill folder's README.md or roadmap files. 4. **Template-heavy** - Provide ready-to-use templates users customize 5. **Platform-specific** - Specific best practices > generic advice +## ClawHub Publishing Constraints + +This repository publishes skills to **ClawHub** (clawhub.com) as the distribution registry. The following rules are **non-negotiable**: + +1. **cs- prefix for slug conflicts only.** When a skill slug is already taken on ClawHub by another publisher, publish with the `cs-` prefix (e.g., `cs-copywriting`, `cs-seo-audit`). The `cs-` prefix applies **only on the ClawHub registry** — repo folder names, local skill names, and all other tools (Claude Code, Codex, Gemini CLI) remain unchanged. +2. **Never rename repo folders or local skill names** to match ClawHub slugs. The repo is the source of truth. +3. **No paid/commercial service dependencies.** Skills must not require paid third-party API keys or commercial services unless provided by the project itself. Free-tier APIs and BYOK (bring-your-own-key) patterns are acceptable. +4. **Rate limit: 5 new skills per hour** on ClawHub. Batch publishes must respect this. Use the drip timer (`clawhub-drip.timer`) for bulk operations. +5. **plugin.json schema** — ONLY these fields: `name`, `description`, `version`, `author`, `homepage`, `repository`, `license`, `skills: "./"`. No extra fields. +6. **Version follows repo versioning.** ClawHub package versions must match the repo release version (currently v2.1.2+). + ## Anti-Patterns to Avoid - Creating dependencies between skills (keep each self-contained) diff --git a/GEMINI.md b/GEMINI.md index 727ca68..060d955 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -22,6 +22,14 @@ Skills are organized into domain folders. Each skill is a directory containing a | **Business & Growth** | `business-growth/` | | **Finance** | `finance/` | +### ClawHub Publishing Constraints + +When skills are published to **ClawHub** (clawhub.com): +- **cs- prefix for slug conflicts only** — applies only on the ClawHub registry when another publisher already owns the slug. Repo folder names and local skill names are never renamed. +- **No paid/commercial service dependencies** — skills must not require paid third-party API keys or commercial services unless provided by the project itself. +- **plugin.json** — ONLY fields: `name`, `description`, `version`, `author`, `homepage`, `repository`, `license`, `skills: "./"`. +- **Rate limit:** 5 new skills/hour on ClawHub. Use drip publishing for bulk operations. + ### Activating a Skill To activate a skill, use the folder name. For example: diff --git a/agents/CLAUDE.md b/agents/CLAUDE.md index 2569e20..9e8b4e9 100644 --- a/agents/CLAUDE.md +++ b/agents/CLAUDE.md @@ -14,6 +14,14 @@ This guide provides comprehensive instructions for creating **cs-* prefixed agen **Key Principle**: Agents ORCHESTRATE skills, they don't replace them. Skills remain self-contained and portable. +### ClawHub Publishing Constraints + +When skills are published to **ClawHub** (clawhub.com): +- **cs- prefix for slug conflicts only** — applies only on the ClawHub registry when another publisher already owns the slug. Repo folder names and local skill names are never renamed. +- **No paid/commercial service dependencies** — skills must not require paid third-party API keys or commercial services unless provided by the project itself. +- **plugin.json** — ONLY fields: `name`, `description`, `version`, `author`, `homepage`, `repository`, `license`, `skills: "./"`. +- **Rate limit:** 5 new skills/hour on ClawHub. Use drip publishing for bulk operations. + ### Production Agents **5 Agents Currently Available** (as of November 5, 2025):