AI Skill for Claude Code

Teach Claude Code (or any agent that understands the SKILL.md format) to share your markdown files as rendered web pages. After installing the skill, just say "share this as a page" and the agent runs sharemd for you.

Install in Claude Code

Inside Claude Code, run these two slash commands:

/plugin marketplace add a2u/sharemd
/plugin install sharemd@sharemd

Claude Code clones the marketplace from GitHub, installs the sharemd plugin, and registers the skill. You can verify with /plugin — the skill appears under installed plugins.

Prerequisite: the CLI

The skill calls the sharemd terminal command. If you haven't installed it, open /panel and copy the one-liner install command — it drops sharemd on your PATH and writes your token to ~/.sharemdrc. The skill does not work without it.

How to use

After install, talk to Claude Code naturally. It auto-invokes the skill when your prompt mentions sharing, publishing, or sending markdown content:

• "Share this README as a page" → sharemd README.md → prints the URL
• "Give me a link to the docs folder" → sharemd docs/ → uploads the whole tree
• "Publish the report I just wrote" → Claude finds the file and uploads with sharemd <file> -f

Other agents / manual install

If you don't use Claude Code's plugin system (or you're on another agent that reads SKILL.md), grab the file directly:

mkdir -p ~/.claude/skills/sharemd
curl -fsSL https://share.nuit.sh/ai-skill?raw > ~/.claude/skills/sharemd/SKILL.md

For Cursor, Codex, or anything using AGENTS.md / .cursorrules, paste the raw skill content into your agent's instruction file.

How it works

The skill is a SKILL.md file with YAML frontmatter. The description tells the agent when to use the skill; the body tells it how. In this case, "how" is: run sharemd file.md or sharemd dir/ from the shell, capture the URL from stdout, pass -f when re-uploading, fall back to the HTTP API if the CLI is missing.

The skill never embeds a token — auth lives in ~/.sharemdrc (sourced by your shell) and is read by the CLI. That means you can freely share the skill file without leaking credentials.

Source

Marketplace catalog: .claude-plugin/marketplace.json. Plugin: plugins/sharemd/. Skill: plugins/sharemd/skills/sharemd/SKILL.md. All in the a2u/sharemd repo — /plugin marketplace update sharemd pulls new versions.