Home / hkuds / vibe-trading · agent/src/skills/doc-reader/SKILL.md · GitHub

doc-reader skillA

doc-reader is agent-read markdown (skill) from hkuds/vibe-trading: Read any common document/data file — PDF, Word (.docx), Excel (.xlsx/.xls), PowerPoint (.pptx), images (OCR), CSV/TSV, plain text, JSON/YAML/TOML, HTML/XML, and most source-code files. Use the `read_document` tool..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.

What the file says

# Universal Document Reader

## Purpose

Return extracted text from any supported file in a single unified JSON
envelope. The tool dispatches by file extension — you always call the same
tool regardless of format.

### Supported formats

| Category | Extensions | Notes |
|---|---|---|
| PDF | `.pdf` | Text pages extracted in ms; scanned/image pages fall back to OCR |
| Word | `.docx` | Paragraphs + table cells |
| Excel | `.xlsx`, `.xls` | All sheets, first 100 rows per sheet as preview |
| PowerPoint | `.pptx` | Slide text content |
| Images | `.png/.jpg/.jpeg/.gif/.bmp/.webp/.tiff` | OCR only |
| CSV / TSV | `.csv`, `.tsv` | Raw text with encoding fallback |
| Plain text | `.txt/.md/.log/.rst` | Encoding fallback |
| Config | `.json/.yaml/.yml/.toml/.ini/.cfg/.env` | Raw text |
| Markup | `.html/.htm/.xml` | Raw text (no HTML stripping) |
| Source code | `.py/.js/.ts/.tsx/.go/.rs/.java/.cpp/.c/.sql/.sh/...` | Raw text |
| Unknown extension | anything else | Best-effort read as UTF-8/GBK text |

**Blocked** (rejected at `/upload`): executables (`.exe/.dll/.so/...`) and
archives (`.zip/.tar/...`). Ask the user to unpack archives locally first.

## Usage
…

Read the whole file at its exact version.

How to install

Latest version
mdr add hkuds/vibe-trading/doc-reader@git:20260715.a45b024
Exact content
mdr add hkuds/vibe-trading/doc-reader@sha256:01fd83063ac5aefc

Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_assb43ecqgz4i4x3.svg)](https://markdownregistry.com/a/art_assb43ecqgz4i4x3)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260715.a45b024 latest2026-07-15 a45b024 6,053 BA view · diff
git:20260417.01996ff2026-04-17 01996ff 3,776 BA view · diff
git:20260409.27354eb2026-04-09 27354eb 2,520 BA view · diff
git:20260401.34eae372026-04-01 34eae37 2,505 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6053 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hkuds/vibe-trading · 34,089 stars · license MIT · pushed 2026-09-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_assb43ecqgz4i4x3
GET https://markdownregistry.com/api/v1/resolve?ref=hkuds/vibe-trading/doc-reader
GET https://markdownregistry.com/api/v1/blob/01fd83063ac5aefc27a4997b0908c612e9cc5936f6fc0df25996be2f2276544b

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from hkuds/vibe-trading

vibe-trading skill
hkuds/vibe-trading · agent/SKILL.md · Professional finance research toolkit — backtesting (10 engines + benchmark comparison panel), factor analysis, Alpha…
v0.1.15 · audit A · 34,089 stars
adr-hshare skill
hkuds/vibe-trading · agent/src/skills/adr-hshare/SKILL.md · ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and…
git:20260409.27354eb · audit A · 34,089 stars
akshare skill
hkuds/vibe-trading · agent/src/skills/akshare/SKILL.md · AKShare financial data aggregator (18k+ stars). Free, no API key. Covers A-shares, US, HK, futures, macro, forex…
git:20260409.27354eb · audit A · 34,089 stars
alpha-zoo skill
hkuds/vibe-trading · agent/src/skills/alpha-zoo/SKILL.md · Browse and bench the bundled alpha zoos — prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib…
git:20260517.1676eaa · audit A · 34,089 stars
ashare-pre-st-filter skill
hkuds/vibe-trading · agent/src/skills/ashare-pre-st-filter/SKILL.md · A 股 ST/*ST 风险预测框架 — 基于最新中报/三季报或业绩预告/快报,预测下一财年是否会因营收、利润、净资产、分红不达标而被风险警示,并将新浪监管处罚记录作为独立证据面纳入风险等级。仅适用于 A 股,不预测财务造假。
git:20260828.18bd2fc · audit A · 34,089 stars
asset-allocation skill
hkuds/vibe-trading · agent/src/skills/asset-allocation/SKILL.md · Asset allocation theory and optimizer usage — MPT / Black-Litterman / risk budgeting / all-weather strategy, including…
git:20260710.fa5e098 · audit A · 34,089 stars
backtest-diagnose skill
hkuds/vibe-trading · agent/src/skills/backtest-diagnose/SKILL.md · Diagnose failed or underperforming backtests, locate the root cause, and fix the issue
git:20260819.ae68820 · audit A · 34,089 stars
behavioral-finance skill
hkuds/vibe-trading · agent/src/skills/behavioral-finance/SKILL.md · Behavioral finance applications: theories of overreaction and underreaction, behavioral explanations for momentum and…
git:20260409.27354eb · audit A · 34,089 stars
bottleneck-hunter skill
hkuds/vibe-trading · agent/src/skills/bottleneck-hunter/SKILL.md · Supply-chain bottleneck arbitrage. Given a super-trend (AI infra, energy transition, defense, semiconductor reshoring…
git:20260706.6c09d25 · audit A · 34,089 stars
candlestick skill
hkuds/vibe-trading · agent/src/skills/candlestick/SKILL.md · Candlestick pattern recognition engine, pure pandas vectorized implementation of 15 classic candlestick patterns (5…
git:20260409.27354eb · audit A · 34,089 stars
ccxt skill
hkuds/vibe-trading · agent/src/skills/ccxt/SKILL.md · CCXT unified crypto exchange library (100+ exchanges). Free public market data. Fallback when OKX is unavailable.
git:20260409.27354eb · audit A · 34,089 stars
chanlun skill
hkuds/vibe-trading · agent/src/skills/chanlun/SKILL.md · 基于缠论(缠中说禅)的形态识别引擎,使用czsc库自动检测K线分型、笔、中枢,并生成一买/一卖/二买/二卖/三买/三卖等买卖点信号。支持多周期分析和形态分类(3/5/7/9/11笔形态)。
git:20260829.1af4019 · audit A · 34,089 stars

Every file in hkuds/vibe-trading

Other files named doc-reader

doc-reader skill
hanzhangzzz/agent-skills-zh · doc-reader/SKILL.md · Translate an English technical article (web URL) or a local PDF into accurate Chinese, section by section with…
git:20260904.c21f62b · audit A · 2 stars

Browse by kind, by grade A, or by owner.