CLI: Push & publish

Publish skills to the hub and find available skills.

Push

npx sundial-hub push reads your local directory, finds the SKILL.md, and publishes it to the Sundial Hub.

Terminal

# Push from current directory
npx sundial-hub push

# Push from a specific path
npx sundial-hub push ./my-skill

SKILL.md format

Every skill needs a SKILL.md with name and description in the frontmatter.version is recommended — if missing, it defaults to 1.

my-skill/SKILL.md

---
name: my-skill
description: One-line summary of what this skill does.
version: 1
---

# My Skill

Instructions the agent follows when this skill is active.

## When to use

Activate when the user asks about...

Supporting files

Everything in the directory gets uploaded alongside SKILL.md:

my-skill/

├── SKILL.md
├── references/
│   └── api-docs.md
└── scripts/
    └── helper.sh

Hidden files, node_modules, and __pycache__ are automatically skipped.

Push options

Terminal

npx sundial-hub push --version 2 --changelog "Added caching" --visibility public --categories coding

Flag	Description
`--version <ver>`	Version to publish (overrides frontmatter)
`--changelog <msg>`	Changelog message for this version
`--visibility <vis>`	public or private
`--categories <cats...>`	Category slugs (optional; prompt appears if omitted)

Versioning

Every push creates an immutable version snapshot. The version comes from the version field in your SKILL.md frontmatter.

Auto-bump

If your requested version matches (or is lower than) what's already published, the CLI automatically bumps to the next version. This works for both simple integers and semver:

Terminal

$ npx sundial-hub push
✔ Found existing skill "my-skill" (v0.2.1)
  Version 0.2.1 is not newer than published v0.2.1. Auto-bumping to v0.2.2.

If your frontmatter version is already newer, it's used directly.

Category	Examples
`Product`	Platform features, deployments
`Research`	Papers, experiments
`Coding`	Dev tools, code generation
`Creative`	Writing, music, design
`Learning`	Study tools, knowledge curation
`Marketing`	Content, demos
`Admin`	Paperwork, subscriptions
`Other`	Everything else

Visibility

Value	Behavior
`public`	Anyone can find and add
`private`	Only you — requires authentication

Find

Find skills from the hub:

Terminal

# Interactive find
npx sundial-hub find

# Search
npx sundial-hub find "web search"

# See your own published skills
npx sundial-hub mine

Finding and adding public skills does not require authentication.