skillet-onboarding

skillet-onboarding

Welcome to Skillet. This skill walks you through the four moments that make Skillet click: install, sync, publish, and add from someone else. It takes about 10 minutes.

Step 1 — Install and first sync (< 2 min)

npx skilletmd

That's it. Skillet installs, scans for skill directories it already knows about (~/.agents/skills, ~/.claude/skills, .cursor/rules, etc.), and shows you what it found. Sign in at skillet.md first — passwordless, an email link — then the wizard links this machine with a pair code from skillet.md → Settings → Devices and runs your first sync. Pairing never uploads your local skills; uploading is a separate, deliberate step.

If you have no skills yet, that's fine — skip to Step 3.

Step 2 — Sync to a second machine

On any other machine:

# Preferred: pair code from skillet.md → Settings → Devices
skillet connect ABCD-1234
skillet sync

Or sign in with email first:

skillet auth login --email [email protected]
skillet sync

If you've already published, sync pulls your kits and writes skills to the correct locations for each runtime.

Step 3 — Publish your first skill (< 5 min)

Create a skill

A skill is a SKILL.md file. The minimum viable skill has a name, a description, and a body:

---
name: my-first-skill
description: "What this skill does and when to trigger it."
---

# my-first-skill

Instructions for the AI go here. Be specific about when to use this
and what behavior you want.

Save it anywhere, then import:

skillet import ./path/to/my-first-skill
skillet sync

Point import at the skill's directory (the one with SKILL.md inside it), not at the file.

Publish

Your handle is claimed when you sign in, so connect this machine first:

skillet connect <code>                    # pair code from skillet.md/settings
skillet upload --skill my-first-skill     # private

Add --public when you want it findable by anyone.