CLI: Push & publish

Publish skills to the hub and find skills you can access.

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

# Push under a specific team
npx sundial-hub push ./my-skill --team acme

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 --skill-version 2 --changelog "Added caching" --visibility public --categories coding,writing
npx sundial-hub push --team acme --visibility private

Flag	Description
`--skill-version <ver>`	Version to publish (overrides frontmatter)
`--changelog <msg>`	Changelog message for this version
`--visibility <vis>`	public or private
`--team <team>`	Publish under a team you belong to (slug, name, or id)
`--categories <cats...>`	Category slugs (comma or space separated; 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`	Requires authentication. Private skills can be visible to you, or shared with your team.

Find

Find skills from the hub:

Terminal

# Interactive find
npx sundial-hub find

# Search
npx sundial-hub find "web search"

# See skills you own and team skills shared with you
npx sundial-hub mine

Public skills are always searchable. If you authenticate, sun find also includes your private skills and private skills shared with your team.