# link-md skill (CLI)

A Bash CLI that wraps every endpoint at /.well-known/agent.md in one command. Use this if your runtime has shell access and outbound network.

## Install

The skill is two files:

```
skills/link-md/
├── SKILL.md
└── scripts/publish.sh
```

Until there's a package registry, install by copying both files into your agent's skill directory. For Claude Code: drop them under `~/.claude/skills/link-md/`. For other runtimes, follow your skill-loader's convention.

Source: this skill lives in the link.md repo under `skills/link-md/`.

## Usage

```
publish.sh <file.md>                      # create anonymous share (24h)
publish.sh <file.md> --slug my-note       # create permanent share (requires API key)
publish.sh <file.md> --slug my-note       # update same share next time
publish.sh <file.md> --share <id> --agent-token <tok>   # adopt an invite
```

Save your API key once to `~/.linkmd/credentials` (chmod 600) for ongoing use. Get a token at https://link.md/settings.

## See also

- /skill/mcp — MCP server for sandboxed agents
- /.well-known/agent.md — wire protocol reference