{"id":"455531ef-29e9-410e-96c3-0e0efbbf5db7","shortId":"TUa78Z","kind":"skill","title":"docuseal-cli","tagline":"Manage DocuSeal e-signature workflows from the terminal via the DocuSeal CLI - create templates from PDF/DOCX/HTML, send documents for signing, track submissions, and update submitters. Use when the user wants to run DocuSeal commands in the shell, scripts, or CI/CD pipelines. Al","description":"## Agent Protocol\n\n**Rules for agents:**\n- Supply ALL required flags — the CLI will not prompt for missing parameters.\n- Output is always JSON.\n- Use `-d key=value` (bracket notation) or `-d '{\"..\": \"..\"}'` (JSON) for body and array parameters.\n\n## Authentication\n\nSet environment variables:\n- `DOCUSEAL_API_KEY` — API key (required). Get yours at https://console.docuseal.com/api\n- `DOCUSEAL_SERVER` — `global` (default), `europe`, or full URL for self-hosted (e.g. `https://docuseal.yourdomain.com`)\n\n## Available Commands\n\n| Command Group | What it does |\n|---|---|\n| `templates` | list, retrieve, update, archive, create-pdf, create-docx, create-html, clone, merge, update-documents |\n| `submissions` | list, retrieve, archive, create, send-emails, create-pdf, create-docx, create-html, documents |\n| `submitters` | list, retrieve, update |\n\nRead the matching reference file for detailed flags and examples.\n\n## Common Mistakes\n\n| # | Mistake | Fix |\n|---|---|---|\n| 1 | **Forgetting `-d template_id=<id>` on `submissions create`** | `--template-id` is a flag; submitters and other body params go via `-d` |\n| 2 | **Passing a plain file path as a URL** | `--file` accepts a local path; for remote files use `-d \"documents[0][file]=https://...\"` |\n| 3 | **Expecting array params as comma-separated** | Arrays use bracket notation: `-d \"template_ids[]=1\"` `-d \"template_ids[]=2\"` |\n| 4 | **Using `templates create-pdf` without a Pro plan** | Commands marked _(Pro)_ require a DocuSeal Pro subscription |\n| 5 | **Sending to multiple recipients with `submissions create`** | Use `submissions send-emails --emails a@b.com,c@d.com` for bulk; `submissions create` is per-submitter |\n\n## Security\n\nThe CLI accepts user-provided file paths, remote URLs (`documents[0][file]=https://...`), and HTML content as template input. This is by design — all content originates from the authenticated user and is sent directly to the DocuSeal API over HTTPS. The CLI does not fetch, render, or execute remote content locally; it passes references to the server for processing. No user input is interpolated into shell commands.\n\n## Common Patterns\n\n**List templates:**\n```bash\ndocuseal templates list --q \"NDA\" --limit 20\n```\n\n**Create a template from a PDF and send for signing:**\n```bash\ndocuseal templates create-pdf --file contract.pdf --name \"NDA\"\ndocuseal submissions send-emails --template-id 1001 --emails signer@example.com\n```\n\n**Create a submission with pre-filled fields (bracket notation):**\n```bash\ndocuseal submissions create --template-id 1001 \\\n  -d \"submitters[0][email]=john@acme.com\" \\\n  -d \"submitters[0][values][Company Name]=Acme Corp\"\n```\n\n**Create a submission with pre-filled fields (JSON):**\n```bash\ndocuseal submissions create --template-id 1001 \\\n  -d '{\"submitters\": [{\"email\": \"john@acme.com\", \"values\": {\"Company Name\": \"Acme Corp\"}}]}'\n```\n\n**Check signing status:**\n```bash\ndocuseal submissions list --template-id 1001 --status pending\n```\n\n**Update a submitter:**\n```bash\ndocuseal submitters update 201 --email new@acme.com --send-email\n```\n\n## When to Load References\n\n- **Creating or managing templates** → [references/templates.md](references/templates.md)\n- **Sending documents for signing or tracking status** → [references/submissions.md](references/submissions.md)\n- **Using dynamic content variables in DOCX** → [references/docx-variables.md](references/docx-variables.md)\n- **Embedding field tags in PDF/DOCX** → [references/field-tags.md](references/field-tags.md)\n- **Writing HTML templates with field tags** → [references/html-fields.md](references/html-fields.md)\n- **Listing or updating signers** → [references/submitters.md](references/submitters.md)","tags":["docuseal","cli","agent","skills","docusealco","agent-skills","agentic-ai","coding-agents"],"capabilities":["skill","source-docusealco","skill-docuseal-cli","topic-agent-skills","topic-agentic-ai","topic-coding-agents"],"categories":["docuseal-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/docusealco/docuseal-agent-skills/docuseal-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add docusealco/docuseal-agent-skills","source_repo":"https://github.com/docusealco/docuseal-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (3,685 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T13:22:58.032Z","embedding":null,"createdAt":"2026-05-18T13:22:58.032Z","updatedAt":"2026-05-18T13:22:58.032Z","lastSeenAt":"2026-05-18T13:22:58.032Z","tsv":"'/api':97 '0':216,292,411,416 '1':174,233 '1001':388,408,438,458 '2':196,237 '20':359 '201':468 '3':218 '4':238 '5':256 'a@b.com':270 'accept':206,283 'acm':420,446 'agent':47,51 'al':46 'alway':66 'api':87,89,318 'archiv':123,141 'array':80,220,226 'authent':82,309 'avail':112 'bash':352,370,401,431,451,464 'bodi':78,191 'bracket':72,228,399 'bulk':273 'c@d.com':271 'check':448 'ci/cd':44 'cli':3,16,57,282,322 'clone':133 'comma':224 'comma-separ':223 'command':38,113,114,248,347 'common':170,348 'compani':418,444 'console.docuseal.com':96 'console.docuseal.com/api':95 'content':296,305,330,495 'contract.pdf':377 'corp':421,447 'creat':17,125,128,131,142,147,150,153,181,242,263,275,360,374,391,404,422,434,478 'create-docx':127,149 'create-html':130,152 'create-pdf':124,146,241,373 'd':69,75,176,195,214,230,234,409,414,439 'default':101 'design':303 'detail':166 'direct':314 'document':22,137,155,215,291,485 'docus':2,5,15,37,86,98,253,317,353,371,380,402,432,452,465 'docuseal-c':1 'docuseal.yourdomain.com':111 'docx':129,151,498 'dynam':494 'e':7 'e-signatur':6 'e.g':110 'email':145,268,269,384,389,412,441,469,473 'embed':501 'environ':84 'europ':102 'exampl':169 'execut':328 'expect':219 'fetch':325 'field':398,429,502,512 'file':164,200,205,212,217,287,293,376 'fill':397,428 'fix':173 'flag':55,167,187 'forget':175 'full':104 'get':92 'global':100 'go':193 'group':115 'host':109 'html':132,154,295,509 'https':320 'id':178,184,232,236,387,407,437,457 'input':299,342 'interpol':344 'john@acme.com':413,442 'json':67,76,430 'key':70,88,90 'limit':358 'list':120,139,157,350,355,454,516 'load':476 'local':208,331 'manag':4,480 'mark':249 'match':162 'merg':134 'miss':62 'mistak':171,172 'multipl':259 'name':378,419,445 'nda':357,379 'new@acme.com':470 'notat':73,229,400 'origin':306 'output':64 'param':192,221 'paramet':63,81 'pass':197,333 'path':201,209,288 'pattern':349 'pdf':126,148,243,365,375 'pdf/docx':505 'pdf/docx/html':20 'pend':460 'per':278 'per-submitt':277 'pipelin':45 'plain':199 'plan':247 'pre':396,427 'pre-fil':395,426 'pro':246,250,254 'process':339 'prompt':60 'protocol':48 'provid':286 'q':356 'read':160 'recipi':260 'refer':163,334,477 'references/docx-variables.md':499,500 'references/field-tags.md':506,507 'references/html-fields.md':514,515 'references/submissions.md':491,492 'references/submitters.md':520,521 'references/templates.md':482,483 'remot':211,289,329 'render':326 'requir':54,91,251 'retriev':121,140,158 'rule':49 'run':36 'script':42 'secur':280 'self':108 'self-host':107 'send':21,144,257,267,367,383,472,484 'send-email':143,266,382,471 'sent':313 'separ':225 'server':99,337 'set':83 'shell':41,346 'sign':24,369,449,487 'signatur':8 'signer':519 'signer@example.com':390 'skill' 'skill-docuseal-cli' 'source-docusealco' 'status':450,459,490 'submiss':26,138,180,262,265,274,381,393,403,424,433,453 'submitt':29,156,188,279,410,415,440,463,466 'subscript':255 'suppli':52 'tag':503,513 'templat':18,119,177,183,231,235,240,298,351,354,362,372,386,406,436,456,481,510 'template-id':182,385,405,435,455 'termin':12 'topic-agent-skills' 'topic-agentic-ai' 'topic-coding-agents' 'track':25,489 'updat':28,122,136,159,461,467,518 'update-docu':135 'url':105,204,290 'use':30,68,213,227,239,264,493 'user':33,285,310,341 'user-provid':284 'valu':71,417,443 'variabl':85,496 'via':13,194 'want':34 'without':244 'workflow':9 'write':508","prices":[{"id":"e9abdb6a-7eff-49b9-8ec5-d404a6eff09f","listingId":"455531ef-29e9-410e-96c3-0e0efbbf5db7","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"docusealco","category":"docuseal-agent-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:58.032Z"}],"sources":[{"listingId":"455531ef-29e9-410e-96c3-0e0efbbf5db7","source":"github","sourceId":"docusealco/docuseal-agent-skills/docuseal-cli","sourceUrl":"https://github.com/docusealco/docuseal-agent-skills/tree/master/skills/docuseal-cli","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:58.032Z","lastSeenAt":"2026-05-18T13:22:58.032Z"}],"details":{"listingId":"455531ef-29e9-410e-96c3-0e0efbbf5db7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"docusealco","slug":"docuseal-cli","github":{"repo":"docusealco/docuseal-agent-skills","stars":6,"topics":["agent-skills","agentic-ai","coding-agents"],"license":"mit","html_url":"https://github.com/docusealco/docuseal-agent-skills","pushed_at":"2026-05-08T14:31:43Z","description":"DocuSeal's official collection of agent skills","skill_md_sha":"e24600d0c0f7005113bface58d7254aa422ac40c","skill_md_path":"skills/docuseal-cli/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/docusealco/docuseal-agent-skills/tree/master/skills/docuseal-cli"},"layout":"multi","source":"github","category":"docuseal-agent-skills","frontmatter":{"name":"docuseal-cli","license":"MIT","description":"Manage DocuSeal e-signature workflows from the terminal via the DocuSeal CLI - create templates from PDF/DOCX/HTML, send documents for signing, track submissions, and update submitters. Use when the user wants to run DocuSeal commands in the shell, scripts, or CI/CD pipelines. Always load this skill before running `docuseal` commands."},"skills_sh_url":"https://skills.sh/docusealco/docuseal-agent-skills/docuseal-cli"},"updatedAt":"2026-05-18T13:22:58.032Z"}}