The localskills share command lets you share a skill file without signing up or logging in. Shared skills are always unlisted — accessible only via the direct URL. They never appear in explore or search results.

Anyone with the link can install the shared skill using localskills install, including users who are not authenticated.

On first use, the CLI generates an Ed25519 keypair stored in ~/.localskills/config.json. The public key is sent to the server, which creates an anonymous user record and issues an API token. The private key never leaves your machine.

If the token is ever lost but the keypair is retained, re-registering with the same public key issues a new token for the same anonymous identity.

Share a specific file, or a whole skill folder (uploaded as a multi-file package):

$ localskills share ./my-skill.md
$ localskills share ./my-skill-folder

Or run without arguments to scan for skill files and select interactively:

$ localskills share

Options:

# Set a custom name
$ localskills share ./skill.md --name "My Custom Skill"

# Share as a rule instead of a skill
$ localskills share ./rule.md --type rule

After sharing, the CLI prints the URL and install command:

URL:     https://localskills.sh/s/k9Xm2pLq
Install: localskills install k9Xm2pLq

The /s/ short link is a permanent identifier: it redirects to the skill's canonical /{owner}/{skill} page and keeps working if the skill is later renamed or moved between folders. Team skills are usually shared by their readable path, e.g. localskills install acme/research/company-lookup.

Your anonymous identity is an Ed25519 keypair stored in ~/.localskills/config.json with 0600 permissions (owner read/write only).

The server stores only the public key. Your private key never leaves your machine and is never transmitted over the network.

Anonymous sharing has the following restrictions:

• Maximum of 10 shared skills per anonymous identity
• All shared skills are unlisted — no public visibility option
• No organization features, analytics, or version history management
• No web dashboard access

For unlimited publishing, organization features, and full platform access, sign up with localskills login.