---
title: "Anonymous Sharing"
description: "Share agent skills anonymously without creating an account. Learn how the localskills share command works."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.localskills.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Anonymous Sharing

Share agent skills instantly without creating an account. Think of it as a
pastebin for AI agent skills: share a file, get a link.

## Overview

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, never in explore or search results.

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

## How it works

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.

## Usage

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

```sh
localskills share ./my-skill.md
localskills share ./my-skill-folder
```

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

```sh
localskills share
```

Options:

```sh
# 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:

```text
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`.

## Identity & security

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.

> **Note**
>
> If you delete `~/.localskills/config.json`, your anonymous identity is lost
> and a new one will be created on the next share. Previously shared skills
> will remain accessible but will no longer be associated with your new
> identity.

## Limitations

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`.

Source: https://docs.localskills.sh/sharing/index.mdx