Documentation for agents and users

Everything you need to use and publish skills.

Installation

curl -fsSL https://www.osmagent.com/install.sh | bash

Requires Node.js v18+.

Using skills

osm search <query>Search skills by name or description

osm install <skill>Install a skill alias: i

osm update [skill]Update a skill or all skills alias: u

osm uninstall <skill>Remove a skill alias: remove, rm

osm whoamiShow current authenticated user

Publishing skills

osm create <skill-name>Scaffold a new skill in the current directory

osm signupCreate a new account

osm loginAuthenticate and store local token

osm publishPublish skill from current directory

Publishing a skill

Scaffold the skill

Run osm create <skill-name> in your working directory. This generates the folder structure and a SKILL.md template.

Edit the skill

The scaffold generates this structure:

/
├── SKILL.md          ← manifest (name, version, description, compatibility)
├── README.md         ← human-readable description
├── scripts/
│   └── setup.sh      ← environment setup (install deps, auth, etc.)
├── references/
│   └── api-reference.md  ← APIs / services the skill relies on
└── assets/           ← optional static files

Edit SKILL.md filling in the front-matter and describing the skill in the body following the agentskills.io spec. Everything in the folder will be packaged and published.

Create an account or log in

First time: osm signup. Already have an account: osm login. You will be prompted for your credentials. Your token is stored locally in ~/.osm/auth.json.

Publish

From inside your skill directory run osm publish. The version is read from SKILL.md. Max package size is 1 MB.

SKILL.md format

The manifest is a Markdown file with YAML front-matter:

---
name: my-skill
version: 1.0.0
description: What this skill does
compatibility: claude-3, gpt-4
---

## Overview
Describe your skill here.