Publishing to ClawHub

ClawHub is the community marketplace for AI agent skills. Publish your Starknet skills to share them with other developers and agents.

What is ClawHub?

ClawHub is a registry and discovery platform for agent skills:

• Browse thousands of community skills
• Install skills with a single command
• Publish your own skills
• Version and update skills over time
• Discover skills by keyword, category, or capability

Preparing for Publication

Before publishing, ensure your skill meets these requirements:

Required Files

Quality Checklist

• Valid YAML frontmatter with all required fields
• Clear, descriptive name and description
• Relevant keywords for discovery
• Working code examples for all operations
• Error handling documentation
• Configuration reference table
• Security considerations noted
• External references and links

Skill Naming

Choose a descriptive, unique name:

# Good names
name: starknet-nft-mint
name: starknet-dao-voting
name: starknet-price-oracle

# Bad names
name: my-skill
name: utils
name: starknet  # Too generic

Naming Rules

• Lowercase letters, numbers, and hyphens only
• 1-64 characters
• Must be unique on ClawHub
• Should describe the capability

Versioning

Skills use semantic versioning (semver):

---
name: starknet-nft-mint
version: 1.2.0
---

Publishing Workflow

1. Create ClawHub Account

# Install ClawHub CLI
npm install -g @clawhub/cli

# Login or create account
claw login

2. Initialize Your Skill

cd skills/my-skill

# Initialize for publishing
claw init

This creates a claw.json manifest:

{
  "name": "starknet-nft-mint",
  "version": "1.0.0",
  "description": "Mint NFTs on Starknet",
  "author": "your-username",
  "repository": "https://github.com/you/starknet-nft-mint",
  "license": "MIT",
  "keywords": ["starknet", "nft", "mint"],
  "starknet": {
    "networks": ["mainnet", "sepolia"],
    "contracts": []
  }
}

3. Validate Your Skill

# Check for issues
claw validate

# Output:
# ✓ SKILL.md found and valid
# ✓ Required fields present
# ✓ Code examples verified
# ✓ Ready to publish

4. Publish

# Publish to ClawHub
claw publish

# Output:
# Publishing starknet-nft-mint@1.0.0...
# ✓ Published successfully
# https://clawhub.com/skills/starknet-nft-mint

Updating Skills

When you make changes:

# Bump version (updates claw.json)
claw version patch  # 1.0.0 -> 1.0.1
claw version minor  # 1.0.0 -> 1.1.0
claw version major  # 1.0.0 -> 2.0.0

# Publish update
claw publish

Discovery Optimization

Help users find your skill:

Keywords

Choose specific, relevant keywords:

keywords:
  - starknet
  - nft
  - erc721
  - mint
  - collection
  - digital-art
  - ipfs
  - metadata

Description

Write a clear, searchable description:

description: >
  Mint NFTs on Starknet ERC-721 collections. Upload metadata
  to IPFS via Pinata, set token URIs, and batch mint multiple
  NFTs. Supports both mainnet and Sepolia testnet.

Categories

Tag your skill with relevant categories:

{
  "categories": ["defi", "nft", "identity", "gaming", "social"]
}

Best Practices

Documentation Quality

Maintenance

• Respond to issues on your repository
• Keep dependencies updated
• Test with new Starknet versions
• Update documentation as protocols change

Community

• Add a CONTRIBUTING.md for contributors
• Use GitHub Issues for bug reports
• Consider a Discord or Telegram for support

Monetization (Future)

ClawHub will support skill monetization:

Example: Publishing Checklist

## Pre-publish Checklist

- [ ] SKILL.md with valid YAML frontmatter
- [ ] README.md with overview and quickstart
- [ ] LICENSE file (MIT, Apache 2.0, etc.)
- [ ] All code examples tested and working
- [ ] Environment variables documented
- [ ] Error handling section complete
- [ ] Security considerations noted
- [ ] Version number set in claw.json
- [ ] Keywords optimized for discovery
- [ ] Repository linked and public

Resources

• ClawHub Website (Coming Soon)
• ClawHub CLI Documentation
• AgentSkills Specification
• Writing Skills Guide

Getting Early Access

Join the ClawHub waitlist to be notified when publishing is available:

1. Visit clawhub.com
2. Enter your email for updates
3. Get early access to the CLI and publishing tools