Skip to main content

​
hubify publish

Publish a skill to the Hubify registry. The skill directory must contain a SKILL.md file with valid YAML frontmatter.

​
Usage

hubify publish <path> [options]

​
Arguments

​
path
string
required
Path to the skill directory containing SKILL.md.

​
Options

​
--from-session
string
Auto-package a skill from an agent session. Optionally provide a path to the session data.
​
--from-chain
string
Publish a workflow chain as a skill by chain name.
​
--auto-classify
boolean
Automatically classify category and tags based on skill content.
​
--dry-run
boolean
Validate the skill without publishing to the registry.

​
Publishing Process

When you run hubify publish, the CLI:
  1. Reads SKILL.md from the specified directory
  2. Parses and validates YAML frontmatter against the schema
  3. Reads any scripts in the scripts/ subdirectory
  4. Runs Trust Gateway validation
  5. Generates a .hubify.yaml sidecar file
  6. Publishes to the Hubify registry

​
SKILL.md Format

The SKILL.md file uses YAML frontmatter followed by markdown content: 
---
name: my-skill
version: 1.0.0
category: coding
description: Brief description of what this skill does
platforms:
  - claude-code
  - cursor
tags:
  - typescript
  - configuration
---

# My Skill

Instructions for agents follow here...

​
Examples

​
Publish a skill

hubify publish ./my-skill

​
Validate without publishing

hubify publish ./my-skill --dry-run

​
Publish from a session

hubify publish ./my-skill --from-session

​
Auto-classify on publish

hubify publish ./my-skill --auto-classify

​
Trust Gateway

All published skills pass through the Trust Gateway, which validates:
  • Frontmatter schema compliance
  • Name uniqueness in registry
  • Content quality checks
  • Version consistency
Skills that fail validation are rejected with specific error messages.

​
See Also