sign — Claude Code command: what it does and how to install
This Claude Code command places a signature or initials image in a PDF. It can use a detected signature field or a location specified for the page.
Apache-2.0 ★ 36,654 updated 2026-10-24
/plugin marketplace add anthropics/knowledge-work-plugins
/plugin install pdf-viewer@knowledge-work-pluginsWhat sign does
The command adds a signature or initials to a PDF as an image annotation. It opens the document and looks for signature fields with page coordinates. If none is found, the agent asks which page and location to use.
The workflow needs a PNG or JPG image and PDF viewing and editing tools. After placing the annotation, the command captures the page for review; its position can then be adjusted. The image source can be a local path or an HTTPS URL, but not a data: URI.
This places a visual image, not a certified or cryptographic digital signature. To add initials throughout a document, the command can create one image annotation per page.
What it helps with
- add a signature image to a PDF field
- place initials at a chosen point on a page
- check signature placement in a page screenshot
- add initials across every page of a PDF
Example prompts for the agent
- Add the signature from
signature.pngto the signature field incontract.pdf. - Place the initials from
initials.jpgat the bottom right of page three inform.pdf. - Add my initials to every page of
document.pdf.
How to install sign
1Plugin marketplace
/plugin marketplace add anthropics/knowledge-work-plugins/plugin install pdf-viewer@knowledge-work-plugins2Manually: put the files in place
.claude/commands/sign.mdCall it with /sign. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/sign.mdCall it with /prompts:sign. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/sign.prompt.mdManually: put the files in place
.gemini/commands/sign.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about sign
How do I install sign in Claude Code?
Run /plugin marketplace add anthropics/knowledge-work-plugins, then /plugin install pdf-viewer@knowledge-work-plugins.
What does sign do?
It places a signature or initials image in a PDF as an annotation, then captures the page so the placement can be checked.
Which image formats does sign accept?
Use a local PNG or JPG file, or an HTTPS URL. data: URIs are not accepted.
Source text
sign.md · Apache-2.0
---
description: Place a signature or initials image on a PDF
argument-hint: "[path-or-url] [signature-image-path]"
---
> If you need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md).
# Sign PDF
Add a visual signature or initials to a document using an image
annotation.
> **Disclaimer:** This places your signature **image** on the page. It
> is **not** a certified or cryptographic digital signature. For
> legally binding e-signatures, use a dedicated signing service.
## Workflow
1. **Get the signature image** — ask the user for a local file path
(PNG/JPG) to their signature or initials. If they don't have one,
suggest they create one and save it to a known path.
2. **Open the PDF** — `display_pdf` (or reuse existing `viewUUID`).
Check the returned `formFields` for signature-type fields — they
include page and bounding-box coordinates.
3. **Locate the target** — if there's a signature field, use its
coordinates. Otherwise ask: "Which page, and where on the page?
(e.g., bottom-right of page 3)"
4. **Place it** — `interact` → `add_annotations`:
```json
{"action": "add_annotations", "annotations": [
{"id": "sig1", "type": "image", "page": 3,
"imageUrl": "/path/to/signature.png",
"x": 400, "y": 700, "width": 150}
]}
```
Width/height auto-detected from the image if omitted.
5. **Verify** — follow with `get_screenshot` of that page. Show the
user. Adjust position if needed via `update_annotations`.
6. **Initials on every page** — batch one `image` annotation per page
in a single `add_annotations` call.
## Tips
- `imageUrl` accepts local file paths or HTTPS URLs (no data: URIs)
- Users can also drag & drop the signature image directly onto the
viewer
- Coordinate origin is top-left; a typical bottom-right signature on
US Letter is around `x: 400, y: 700`
- Pair with `/pdf-viewer:fill-form` for complete form workflows
© Anthropic · Apache-2.0 · anthropics/knowledge-work-plugins