AgentSkillsCN

nudocs

通过 Nudocs.ai 上传、编辑和导出文档。当创建可共享的文档链接以便协同编辑、将 markdown/文档上传到 Nudocs 进行丰富编辑,或拉回已编辑内容时使用。触发词:“send to nudocs”、“upload to nudocs”、“edit in nudocs”、“pull from nudocs”、“get the nudocs link”、“show my nudocs documents”。

SKILL.md
--- frontmatter
name: nudocs
description: Upload, edit, and export documents via Nudocs.ai. Use when creating shareable document links for collaborative editing, uploading markdown/docs to Nudocs for rich editing, or pulling back edited content. Triggers on "send to nudocs", "upload to nudocs", "edit in nudocs", "pull from nudocs", "get the nudocs link", "show my nudocs documents".
homepage: https://nudocs.ai
metadata:
  clawdbot:
    emoji: "📄"
    requires:
      bins: ["nudocs"]
    install:
      - id: npm
        kind: node
        package: "@nutrient-sdk/nudocs-cli"
        bins: ["nudocs"]
        label: "Install Nudocs CLI (npm)"

Nudocs

Upload documents to Nudocs.ai for rich editing, get shareable links, and pull back the results.

Setup

  1. Install the CLI:
bash
npm install -g @nutrient-sdk/nudocs-cli
  1. Get your API key from https://nudocs.ai (click "Integration" after signing in)

  2. Configure the key:

bash
# 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

bash
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

  1. Create/write document content
  2. Save as markdown (or other supported format)
  3. Run: nudocs upload <file>
  4. Share the returned edit link with user

Pull Flow

  1. User requests document back
  2. Run: nudocs pull [ulid] --format <fmt>
  3. Read and present the downloaded file

Format Selection

ScenarioRecommended Format
User edited with rich formattingdocx (default)
Simple text/code contentmd
Final delivery/sharingpdf

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

code
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

ErrorCauseSolution
"No API key found"Missing credentialsSet 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 keyRegenerate key in Nudocs settings
"No ULID provided"Missing document IDSpecify ULID or upload a doc first

Links