docs: add ClawHub publishing constraints to CLAUDE.md, agents/CLAUDE.md, GEMINI.md
- cs- prefix for slug conflicts only (ClawHub registry, not repo) - No paid/commercial service dependencies - Rate limit: 5 new skills/hour - plugin.json schema enforcement - Version must match repo release
This commit is contained in:
11
CLAUDE.md
11
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)
|
||||
|
||||
@@ -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:
|
||||
|
||||
@@ -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):
|
||||
|
||||
Reference in New Issue
Block a user