Your First Skill

This walks through the full author → review → install loop. It assumes you've already run sherpi login and configured an editor with sherpi setup.

1. Scaffold

sherpi skills create hello-world

This creates .claude/skills/hello-world/ (or your editor's equivalent path) containing SKILL.md, assets/, and scripts/.

2. Edit the skill

Open SKILL.md. It's a markdown file with YAML frontmatter. The scaffold includes a commented reference block at the top showing every supported field — read it before editing.

---
name: hello-world
description: Greets the user by name and lists today's tasks.
tags: [demo, productivity]
---

# Hello World

When the user asks to say hello:

1. Ask for their name
2. Check today's date
3. Greet them warmly with a short summary of any tasks they've mentioned

3. Check it locally

sherpi skills check hello-world

Validates the frontmatter and any referenced files. Nothing is uploaded — purely local.

4. Publish

sherpi skills publish hello-world

Your skill is uploaded and goes live. If your org has review enabled, it enters the review queue for admin approval.

Tag behavior on publish:

• Omit the tags: line → server preserves existing tags
• tags: [] → clears tags
• tags: [a, b] → replaces with those exact tags

5. Install

Once published:

sherpi skills install hello-world

By default this installs at project scope (./.claude/skills/hello-world). To install at user scope (available across every project on this machine):

sherpi skills install hello-world --user

6. Use it

In Claude Code, Cursor, or your other configured editor, invoke the skill with a slash command (e.g. /hello-world in Claude Code) or by asking the agent something that matches its description. The agent discovers the skill via its description and follows its instructions.