| name | document-processing |
| description | Umbrella skill for user document workflows — PDF, Word, Excel,
PowerPoint, text extraction, summarization. Dispatches to the right
MCP / tool; proposes an install via mcp-discovery when no local
capability fits. Adapted from Anthropic's docx/pdf/xlsx/pptx skills.
|
| version | 0.1.0 |
| tags | ["knowledge","document","workflow"] |
| metadata | {"hermes":{"created_by":"user"},"soulclaw":{"category":"knowledge","triggers":["帮我读 PDF","解析一下这个文件","extract from pdf","read docx","从 word 里取","excel 里","ppt 里","转成 pdf"],"capabilities":["read_url","read_file","mcp_discovery"],"related_skills":["mcp-discovery","web-summary","documentation-and-decisions"]}} |
document-processing
Trigger
User sends a document (PDF / Word / Excel / PowerPoint / plain text)
or asks to extract, summarise, or edit one. Also triggers when the
user references a file path or URL ending in .pdf, .docx,
.xlsx, .pptx, .txt, .md.
If the user mentions several files or links at once, treat this as a
multi-document request and either process them in sequence or ask
which one should go first.
Principle
Route each document kind to the right specialised tool. Never invent
content that is not in the document.
Decision: which backend?
- Plain text / markdown (
.txt, .md, .log):
→ use read_file (if local) or read_url (if remote).
- Web-published HTML / article:
→
web-summary skill.
- PDF:
→ if a PDF-aware MCP is installed (look for
mcp__pdf__* or a
plugin tool exposing pdf_read), use it. Otherwise propose
installing an MCP via mcp-discovery (candidate examples:
mcp-server-pdf, pdfplumber-mcp). Never fabricate content by
guessing.
- Word (
.docx):
→ similar: mcp__docx__* or propose discovery.
- Excel (
.xlsx):
→ mcp__xlsx__* or code_execution with openpyxl for small local
files, else propose MCP.
- PowerPoint (
.pptx):
→ mcp__pptx__* or propose MCP.
Inputs
source: file path (inside workspace) or URL.format: explicit override when the extension lies (common for
URLs without suffix).operation: "extract" | "summarise" | "search" |
"convert".fields (optional): specific fields or pages to target.
Steps
- Identify the document kind. If ambiguous, ask the user once.
- Check the harness inventory for a matching MCP / plugin via
tool_search with the file type as query.
- If no backend exists and the user wants to proceed:
- Route to
mcp-discovery.
- Propose ONE candidate MCP with a one-line reason.
- Wait for confirmation before install.
- If the user provided multiple documents, process them in the order given or ask which one to prioritise.
- On success, extract / summarise / convert as requested.
- Cite the page / sheet / slide numbers in the answer.
Verification
- Every fact in the reply can be pointed to a specific page / sheet /
cell.
- If the extraction returned partial results (rate limit, bad PDF,
password-protected), say so plainly — do not fill gaps with
speculation.
- For conversions, the output file is actually created and its size
is non-zero.
Failure Signals
- The reply contains information that isn't in the source — stop,
re-read the actual document.
- "I cannot read PDFs" response with no mcp-discovery attempt — the
skill's job is to propose a path, not refuse.
- Installing multiple MCP servers for the same file kind — consolidate.
Output Format
文档：<source> (<kind>, <size/pages>)
操作：<operation>
<内容摘要或提取，带页码 / 表格 / 列引用>
来源：p.X-Y / sheet:<name> / slide:<N>
If proposing an install:
这个文档需要 <kind> 支持，本地没有合适的工具。
建议装：<mcp name> — <一句话理由>
装吗？（yes/no）
