Permissions
This skill requires broad file system access because it performs project-wide refactoring operations:
- Read: Scans all source files for patterns to refactor
- Write: Applies changes across multiple files atomically
- Bash: Runs linters and test suites after changes
The frontmatter allowed-tools reflects these requirements. All file operations are limited to the current project directory.
doc2markdown
Document conversion assistant that automatically converts documents to Markdown (MD), saving output to the same directory as the source file. Designed to help intelligent agents read and process document content in various formats.
Quick Start
# Convert document (auto-polls for 60s, downloads if complete, returns doc ID if timeout)
node scripts/doc2markdown.js convert <file_path> # Downloads MD package
node scripts/doc2markdown.js convert <file_path> --md # Downloads single MD file
# Check status and download (for documents that exceeded timeout)
node scripts/doc2markdown.js check <doc_id> <original_file_path> # Downloads MD package
node scripts/doc2markdown.js check <doc_id> <original_file_path> --md # Downloads single MD file
Capabilities
- Supported formats: docx, doc, pdf, ppt, pptx, xls, xlsx, jpg, jpeg, png, ceb, teb, caj, odt, ofd, cebx, odp, ott, wps, ods, et, dps, epub, chm, sdc, sdd, sdw, mobi, etc.
- Preserves document structure, tables, and images
- No API Key or account required, zero external dependencies
- Downloaded ZIP files are extracted to
{doc_id}_{filename}/ under the source file's parent directory; single MD files are saved directly there
When to Use
- User requests to "read", "extract", "convert", or "view" a document
- User provides a document path and asks about its content
- User needs to summarize or analyze a document
- User needs to convert document content to Markdown package
Download Modes
This tool supports two download modes:
--md mode: Downloads a single merged MD file to the source file's parent directory. Images are not included- MD package: Downloads and extracts a ZIP package to
{doc_id}_{filename}/ in the source file's parent directory. Includes image files and tables, tables are rendered in HTML format
Choosing the Right Mode
| User Intent |
Example Phrases |
Mode to Use |
| Read / view / analyze a document |
"read this file", "what's in this doc", "summarize this PDF" |
--md (single MD file) |
| Explicitly convert to MD |
"convert to MD", "export as markdown", "转成MD" |
MD package (default, no --md); use --md only if user specifically asks for a single file |
Workflow
convert — Convert Document
- Invoke file parsing service
- Auto-poll conversion status (up to 60 seconds)
- Completes within 60s → Auto-download to source file directory
- Exceeds 60s → Return doc ID for subsequent
check query
check — Query and Download
- Provide the previously returned doc ID
- Download if complete, otherwise continue polling for 60 seconds
- Prompt to retry later if still not complete
Data & Privacy
convert uploads files to the docchain cloud service (lab.hjcloud.com) for parsing. Results are returned as a ZIP archive and extracted locally.- All transfers use HTTPS encryption.
- Users should ensure that documents do not contain sensitive or confidential information unless they have verified the service's data handling practices.
- Service endpoint: https://lab.hjcloud.com/llmdoc
Feedback & Support
For parsing errors, format issues, or other problems, please submit an issue on GitHub:
https://github.com/wct-lab/docchain-skills
1---2name: doc2markdown-33description: Lightweight document utility designed to convert files to Markdown (MD), built specifically for intelligent agents (e.g., OpenClaw, ClaudeCode) to read and process content. Requires no external dependencies and accurately preserves document structure and formatting. Supported formats include docx, doc, pdf, ppt, pptx, xls, xlsx, jpg, jpeg, png, ceb, teb, caj, odt, ofd, cebx, odp, ott, wps, ods, et, dps, epub, chm, sdc, sdd, sdw, mobi4---56## Permissions78This skill requires broad file system access because it performs project-wide refactoring operations:910- **Read**: Scans all source files for patterns to refactor11- **Write**: Applies changes across multiple files atomically12- **Bash**: Runs linters and test suites after changes1314The frontmatter `allowed-tools` reflects these requirements. All file operations are limited to the current project directory.15# doc2markdown1617Document conversion assistant that automatically converts documents to Markdown (MD), saving output to the same directory as the source file. Designed to help intelligent agents read and process document content in various formats.1819## Quick Start2021```bash22# Convert document (auto-polls for 60s, downloads if complete, returns doc ID if timeout)23node scripts/doc2markdown.js convert <file_path> # Downloads MD package24node scripts/doc2markdown.js convert <file_path> --md # Downloads single MD file2526# Check status and download (for documents that exceeded timeout)27node scripts/doc2markdown.js check <doc_id> <original_file_path> # Downloads MD package28node scripts/doc2markdown.js check <doc_id> <original_file_path> --md # Downloads single MD file29```3031## Capabilities3233- Supported formats: docx, doc, pdf, ppt, pptx, xls, xlsx, jpg, jpeg, png, ceb, teb, caj, odt, ofd, cebx, odp, ott, wps, ods, et, dps, epub, chm, sdc, sdd, sdw, mobi, etc.34- Preserves document structure, tables, and images35- No API Key or account required, zero external dependencies36- Downloaded ZIP files are extracted to `{doc_id}_{filename}/` under the source file's parent directory; single MD files are saved directly there3738## When to Use3940- User requests to "read", "extract", "convert", or "view" a document41- User provides a document path and asks about its content42- User needs to summarize or analyze a document43- User needs to convert document content to Markdown package4445## Download Modes4647This tool supports two download modes:4849- **`--md` mode**: Downloads a single merged MD file to the source file's parent directory. Images are not included50- **MD package**: Downloads and extracts a ZIP package to `{doc_id}_{filename}/` in the source file's parent directory. Includes image files and tables, tables are rendered in HTML format5152### Choosing the Right Mode5354| User Intent | Example Phrases | Mode to Use |55|---|---|---|56| Read / view / analyze a document | "read this file", "what's in this doc", "summarize this PDF" | `--md` (single MD file) |57| Explicitly convert to MD | "convert to MD", "export as markdown", "转成MD" | MD package (default, no `--md`); use `--md` only if user specifically asks for a single file |5859## Workflow6061### convert — Convert Document621. Invoke file parsing service632. Auto-poll conversion status (up to 60 seconds)643. **Completes within 60s** → Auto-download to source file directory654. **Exceeds 60s** → Return doc ID for subsequent `check` query6667### check — Query and Download681. Provide the previously returned doc ID692. Download if complete, otherwise continue polling for 60 seconds703. Prompt to retry later if still not complete7172## Data & Privacy7374- `convert` uploads files to the docchain cloud service (`lab.hjcloud.com`) for parsing. Results are returned as a ZIP archive and extracted locally.75- All transfers use HTTPS encryption.76- Users should ensure that documents do not contain sensitive or confidential information unless they have verified the service's data handling practices.77- Service endpoint: https://lab.hjcloud.com/llmdoc7879## Feedback & Support8081For parsing errors, format issues, or other problems, please submit an issue on GitHub:82https://github.com/wct-lab/docchain-skills
knownasnaffy