Nudocs
Verified@jdrhyne
npx machina-cli add skill @jdrhyne/nudocs --openclawNudocs
Upload documents to Nudocs.ai for rich editing, get shareable links, and pull back the results.
Setup
- Install the CLI:
npm install -g @nutrient-sdk/nudocs-cli
-
Get your API key from https://nudocs.ai (click "Integration" after signing in)
-
Configure the key:
# Option 1: Environment variable
export NUDOCS_API_KEY="nudocs_your_key_here"
# Option 2: Config file
mkdir -p ~/.config/nudocs
echo "nudocs_your_key_here" > ~/.config/nudocs/api_key
Commands
nudocs upload <file> # Upload and get edit link
nudocs list # List all documents
nudocs link [ulid] # Get edit link (last upload if no ULID)
nudocs pull [ulid] [--format fmt] # Download document (default: docx)
nudocs delete <ulid> # Delete a document
nudocs config # Show configuration
Workflow
Upload Flow
- Create/write document content
- Save as markdown (or other supported format)
- Run:
nudocs upload <file> - Share the returned edit link with user
Pull Flow
- User requests document back
- Run:
nudocs pull [ulid] --format <fmt> - Read and present the downloaded file
Format Selection
| Scenario | Recommended Format |
|---|---|
| User edited with rich formatting | docx (default) |
| Simple text/code content | md |
| Final delivery/sharing | pdf |
See references/formats.md for full format support.
Natural Language Triggers
Recognize these user intents:
Upload/Send:
- "send to nudocs"
- "upload to nudocs"
- "open in nudocs"
- "edit this in nudocs"
- "let me edit this in nudocs"
- "put this in nudocs"
Pull/Fetch:
- "pull it back"
- "pull from nudocs"
- "get that doc"
- "fetch from nudocs"
- "download from nudocs"
- "grab the updated version"
- "what did I change"
- "get my edits"
Link:
- "get the nudocs link"
- "share link"
- "where's that doc"
- "nudocs url"
List:
- "show my nudocs"
- "list my documents"
- "what docs do I have"
- "my nudocs documents"
Document Best Practices
Before uploading, ensure good structure:
- Clear heading hierarchy (H1 → H2 → H3)
- Consistent spacing
- Appropriate list formatting
- Concise paragraphs (3-5 sentences)
See references/document-design.md for templates and guidelines.
Example Session
User: Write me a blog post about remote work and send it to Nudocs
Agent:
1. Writes blog-remote-work.md with proper structure
2. Runs: nudocs upload blog-remote-work.md
3. Returns: "Here's your Nudocs link: https://nudocs.ai/file/01ABC..."
User: *edits in Nudocs, adds formatting, images*
User: Pull that back
Agent:
1. Runs: nudocs pull --format docx
2. Reads the downloaded file
3. Returns: "Got your updated document! Here's what changed..."
Error Handling
| Error | Cause | Solution |
|---|---|---|
| "No API key found" | Missing credentials | Set NUDOCS_API_KEY or create config file |
| "DOCUMENT_LIMIT_REACHED" | Free tier limit (10 docs) | Delete old docs or upgrade to Pro |
| "Unauthorized" | Invalid API key | Regenerate key in Nudocs settings |
| "No ULID provided" | Missing document ID | Specify ULID or upload a doc first |
Links
- CLI: https://github.com/PSPDFKit/nudocs-cli (
@nutrient-sdk/nudocs-clion npm) - MCP Server: https://github.com/PSPDFKit/nudocs-mcp-server
- Nudocs: https://nudocs.ai
Overview
Nudocs lets you upload documents to Nudocs.ai for rich editing, generate shareable edit links, and pull edited content back into your workflow. It supports collaborative editing through links, and exports in multiple formats. Use it to streamline document collaboration from upload to final delivery.
How This Skill Works
Install the Nudocs CLI, configure your API key, and use nudocs commands to upload, list, link, pull, or delete documents. The workflow typically involves uploading a file (often Markdown or other supported formats), sharing the generated edit link for collaboration, and pulling back the edited document in your preferred format (docx, md, pdf).
When to Use It
- You need a shareable edit link for collaborative document editing.
- You want to upload Markdown or other supported formats to Nudocs for rich editing.
- You need to pull back the edited document after collaborators finish.
- You want to list or manage your Nudocs documents from the CLI.
- You need a final export in a specific format (docx, md, or pdf) for delivery.
Quick Start
- Step 1: Install Nudocs CLI (npm i -g @nutrient-sdk/nudocs-cli)
- Step 2: Get API key from Nudocs and configure (export NUDOCS_API_KEY=... or write to ~/.config/nudocs/api_key)
- Step 3: Upload a file and share the edit link with nudocs upload <file>
Best Practices
- Structure content with a clear heading hierarchy before uploading (H1 → H2 → H3).
- Save drafts in Markdown or a supported format to maximize editability.
- Share the Nudocs edit link with collaborators to enable real-time feedback.
- Choose the appropriate final format (docx, md, pdf) based on delivery needs.
- Securely store your Nudocs API key using environment variables or a config file.
Example Use Cases
- Upload a product spec as Markdown and share an edit link for engineering feedback.
- Collaborate on a blog post by sending the Nudocs edit link to a writer.
- Pull the edited docx back after reviews and distribute to stakeholders.
- List all documents to identify what needs updates or archiving.
- Export the final version as PDF for formal distribution.
