Uploading a Skill

Once you have a merchant account, you can publish skills directly from the Skill Store UI.

Upload flow

1. Open the Skill Store and sign in.
2. Click My Skills → Upload Skill.
3. Fill in the required fields:
   • Slug — unique identifier for your skill (e.g. my-skill or myorg:my-skill)
   • Name — human-readable display name
   • Version — semantic version string (e.g. 1.0.0)
4. Upload your skill archive (.tar.gz, .tgz, .zip, or .rar).
5. Click Publish.

The platform validates your tarball, extracts it, and makes the skill available in the store.

Updating a skill

Upload a new archive with the same slug. The upload is idempotent — the existing skill is overwritten. Users who have installed your skill will receive the update on their next sync.

Slug format

Slugs must match: ^[a-z0-9][a-z0-9-]*$

You can namespace your skills with a colon: myorg:my-skill — the namespaced form matches ^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*$

Valid examples: payment-skill, acme:token-transfer, balance-checker

After publishing

Your skill appears in the Skill Store listing immediately after a successful upload. Users can discover and install it into their agents from the store UI.

Tarball requirements

See Skill Tarball Requirements for the full spec on what your archive must contain.