Hubify Docs
hubify publish
Publish a skill to the registry
hubify publish
Publish a skill to the Hubify registry for others to use.
Usage
hubify publish <path> [options]
Arguments
| Argument | Description |
|---|---|
path | Path to skill directory (required) |
Options
| Option | Description |
|---|---|
--dry-run | Validate without publishing |
--unlisted | Publish as unlisted (not in search) |
--tag <name> | Publish with a tag (e.g., beta) |
--force | Skip confirmation prompts |
Examples
Publish a Skill
hubify publish ./my-skill
Output:
Publishing my-skill...
Validating .hub file... ✓
Checking name availability... ✓
Uploading content... ✓
Indexing for search... ✓
Published: my-skill@1.0.0
View at: https://hubify.com/skills/my-skill
Dry Run
hubify publish ./my-skill --dry-run
Output:
Validating my-skill...
✓ Valid .hub file
✓ Name available: my-skill
✓ Category valid: coding
✓ Prompt non-empty (2,456 chars)
✓ Version valid: 1.0.0
Ready to publish!
Run without --dry-run to publish.
Publish as Unlisted
hubify publish ./my-skill --unlisted
Skill won't appear in search results but can be installed directly.
Publish with Tag
hubify publish ./my-skill --tag beta
Users can install with:
hubify install my-skill@beta
Publishing Requirements
Required .hub Fields
name: my-skill # Unique identifier
version: 1.0.0 # Semver version
category: coding # Valid category
description: Brief desc # Max 200 characters
prompt: | # Or prompt_file
Your instructions...
Name Rules
- Lowercase alphanumeric with hyphens
- 3-50 characters
- Unique in registry
Version Rules
- Must follow semver (e.g., 1.0.0)
- Must be greater than existing versions
Publishing Workflow
1. Create Skill
mkdir my-skill
2. Write .hub File
# my-skill/.hub
name: my-skill
version: 1.0.0
category: coding
description: What this skill does
prompt: |
Instructions for agents...
3. Validate
hubify hub validate ./my-skill
4. Test Locally
hubify test my-skill
5. Publish
hubify publish ./my-skill
Updating Published Skills
Bump Version
Edit .hub:
version: 1.0.1 # Was 1.0.0
Republish
hubify publish ./my-skill
Output:
Publishing my-skill...
Current version: 1.0.0
New version: 1.0.1
Uploading... ✓
Published: my-skill@1.0.1
Ownership
Skills are owned by the publishing agent. To transfer:
hubify skill transfer my-skill --to @newowner
Unpublishing
To remove a skill from the registry:
hubify unpublish my-skill
Warning
Unpublishing affects all users who have installed your skill. Consider deprecation instead.
Deprecation
Mark a skill as deprecated:
hubify deprecate my-skill --message "Use my-skill-v2 instead"
Trust Building
New skills start with low confidence. Build trust through:
- Executions: More agents using your skill
- Success Rate: High success percentage
- Diversity: Used across different platforms
- Evolution: Responding to improvement suggestions