Agent skill

Document

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

MITAuto-check passedDocuments & Office

Install Document

skills CLI
$ npx skills add ZimoLiao/scholaraio --skill document -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZimoLiao/scholaraio document --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/document .claude/skills/document && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
document
GitHub stars
576
Token cost
~674 tokens
SKILL.md length
169 words
Files
4 (incl. references)
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

  • Works in 7 steps: 明确最终格式、受众、语言、模板、页数或篇幅,以及是否需要可编辑源文件。 → 使用当前会话实际可用的原生能力完成内容、故事线和视觉方案;需要文献数据时再组合… → 只读取与目标格式对应的实现参考 → …
  • The user wants to create
  • SKILL.md covers Capability Routing, Output Contract, Workflow and Inspection Commands, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Document is an agent skill from ZimoLiao/scholaraio. Use when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio document inspect.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/docx.md`, `references/pptx.md` and `references/xlsx.md`).

It sits in Documents & Office, covering Excel spreadsheets, PowerPoint presentations and Word documents. It works with Microsoft Excel, Microsoft PowerPoint and Microsoft Word. The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

  • The user wants to create
  • Generate a downloadable Office deliverable
  • Verify its structure and layout warnings with scholaraio document inspect

Example prompts

  • “/document”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 明确最终格式、受众、语言、模板、页数或篇幅,以及是否需要可编辑源文件。
  2. 使用当前会话实际可用的原生能力完成内容、故事线和视觉方案;需要文献数据时再组合 ScholarAIO 的检索或写作 skill。
  3. 只读取与目标格式对应的实现参考
  4. 用一个可重复运行的 Python 脚本生成文件。脚本与产物都放在对应 workspace 中,避免散落临时代码。
  5. 运行 scholaraio document inspect ;发现结构问题或溢出警告时,修改脚本、重新生成并再次检查。
  6. 若当前会话实际具备 Office/PDF 渲染或页面预览能力,再对所有页面或幻灯片做视觉检查。否则明确说明只完成了结构检查和启发式布局检查,不要声称已经视觉验收。
  7. 向用户提供最终文件路径、格式和已完成的检查。

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Document loads about 674 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 169 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~674
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 169 words, ~674 tokens.

Download SKILL.mdSave it as .claude/skills/document/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
document
description
Use when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio document inspect.

Office 文档生成与检查

Capability Routing

当前 Agent 原生能力优先,但必须先做能力检查:按最终交付物路由,不按 Agent 品牌路由。若当前会话实际提供内容写作、演示设计、图表或版式能力,就由当前使用的 Agent 原生能力先完成内容与视觉方案。只有用户需要可下载、可复现的 DOCX/PPTX/XLSX 文件时,才使用本 skill 的 Office API 和检查闭环。

Output Contract

用户要的产物默认实现必做检查
正式报告、综述、简报python-docx → DOCX标题层级、段落、表格、图片、样式
汇报、演示、答辩python-pptx → PPTX页数、shape 边界、文字溢出警告、图片、表格
数据表、统计、清单openpyxl → XLSXsheet、数据范围、冻结窗格、格式、图表

把用户交付物写到 workspace/ 下;正式文件默认放 workspace/reports/,系统生成图表默认放 workspace/_system/figures/。不要把产物写到仓库根目录。

Workflow

  1. 明确最终格式、受众、语言、模板、页数或篇幅,以及是否需要可编辑源文件。
  2. 使用当前会话实际可用的原生能力完成内容、故事线和视觉方案;需要文献数据时再组合 ScholarAIO 的检索或写作 skill。
  3. 只读取与目标格式对应的实现参考:
  4. 用一个可重复运行的 Python 脚本生成文件。脚本与产物都放在对应 workspace 中,避免散落临时代码。
  5. 运行 scholaraio document inspect <file>;发现结构问题或溢出警告时,修改脚本、重新生成并再次检查。
  6. 若当前会话实际具备 Office/PDF 渲染或页面预览能力,再对所有页面或幻灯片做视觉检查。否则明确说明只完成了结构检查和启发式布局检查,不要声称已经视觉验收。
  7. 向用户提供最终文件路径、格式和已完成的检查。

Inspection Commands

bash
scholaraio document inspect workspace/reports/report.docx
scholaraio document inspect workspace/reports/presentation.pptx
scholaraio document inspect workspace/reports/data.xlsx

document inspect 是结构化检查器:

  • PPTX:报告每页 shape 的位置、尺寸和内容,并给出边界/文字溢出启发式警告。
  • DOCX:报告章节、段落、表格、图片和样式结构。
  • XLSX:报告 sheet、数据范围、冻结窗格、合并单元格、预览和图表。

它不能代替完整的 Office 渲染器。无警告不等于视觉布局一定正确。

Composition Rules

前置任务组合方式
绘制流程图或论文图/draw 生成 SVG/PNG,再嵌入 Office 文件
搜索或整理论文/search、/workspace 或写作 skill 先生成有来源的内容
文献综述或论文章节/literature-review 或 /paper-writing 先完成内容,再封装 DOCX
普通演示稿先完成故事线与逐页内容,再生成 PPTX

Quality Gates

  • 保留输入数据、生成脚本和最终 Office 文件,使交付可重复生成。
  • 不编造引用、图表数据或缺失内容;无法核验的内容必须标注。
  • DOCX 使用语义化标题样式,不用手工字号假装标题层级。
  • PPTX 统一页面尺寸、边距、标题层级和视觉网格,避免默认模板堆字。
  • XLSX 保留原始数据精度,显式设置数字格式、冻结表头和筛选范围。
  • 检查结果失败或出现警告时,先修复再交付;不能修复时明确列出剩余问题。

Simple Conversion Escape Hatch

只有简单 Markdown → DOCX 且不需要高级排版时,才使用:

bash
scholaraio export docx --input workspace/report.md --output workspace/reports/report.docx

即使使用快捷转换,也要运行 scholaraio document inspect。

Examples

用户说:“帮我总结文献库,交付一份 Word 简报” → 先检索和核验内容 → 读取 DOCX 参考 → 生成 DOCX → inspect → 有渲染能力时再视觉检查

用户说:“把工作区论文做成给导师汇报的 PPT” → 先组织故事线和逐页信息 → 读取 PPTX 参考 → 生成 PPTX → inspect → 逐页视觉检查

用户说:“把论文统计导出为 Excel” → 获取结构化数据 → 读取 XLSX 参考 → 生成带格式和筛选的 XLSX → inspect

© ZimoLiao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .claude/skills/document of ZimoLiao/scholaraio.

  • SKILL.md
  • references/docx.md
  • references/pptx.md
  • references/xlsx.md

Open the folder on GitHubat commit 777628b

Compare with similar skills

Document next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Document compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Document this skillZimoLiao/scholaraio576—~674Automated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Docx4jplutext/docx4j2.4k—~2.5kAutomated safety check: PassNone
Cyber Pptcrazyykhllc-bit/CyberPPT1.8k—~10kAutomated safety check: PassMIT
Markitshift-labs-ai/markit1.3k—~299Automated safety check: PassMIT
Markitdownjimmc414/Kosmos5942 repos~1.7kAutomated safety check: PassNone

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Docx4j

    plutext/docx4j

    A skill your agent uses when writing Java code that creates, reads or edits Word (.docx), PowerPoint (.pptx) or Excel (.xlsx) files with docx4j — including generating documents, editing existing…

    2.4k GitHub stars~2.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Cyber Ppt

    crazyykhllc-bit/CyberPPT

    当用户需要把 DOCX、PDF、TXT、XLSX、研究报告、业务材料或原始数据转成高密度、可编辑、咨询风格 PPTX 时使用;也适用于需要 SCR 论证、视觉风格探索、详细图表和渲染质检的 PPT。

    1.8k GitHub stars~10k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Markitdown

    jimmc414/Kosmos

    Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.

    594 GitHub starsUsed in 2 repos~1.7k tokens
    Documents & OfficeAuto-check passed
  • Liteparse

    bastani-inc/atomic

    A skill your agent uses whenever a task involves a document file (PDF, DOCX, PPTX, XLSX, or image) and you need to read it or pull text, tables, or specific values out of it — to answer a question…

    846 GitHub stars~1.4k tokensUpdated today
    Documents & OfficeAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    576 GitHub stars~827 tokensUpdated 12 days ago
    Auto-check passed
  • Arxiv

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to browse arXiv preprints, search arXiv directly, fetch a PDF by arXiv ID or URL, or send a preprint into the ScholarAIO ingest pipeline.

    576 GitHub stars~799 tokensUpdated 12 days ago
    Auto-check passed
  • Bioinformatics

    ZimoLiao/scholaraio

    A skill your agent uses when working on bioinformatics workflows such as alignment, variant calling, phylogenetics, or protein-structure analysis, especially across BLAST, minimap2, samtools…

    576 GitHub stars~1.4k tokensUpdated 12 days ago
    Auto-check passed
  • Citation Check

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to verify citations in AI-generated or human-written text against the local knowledge base and catch hallucinated, wrong, or missing references.

    576 GitHub stars~454 tokensUpdated 12 days ago
    Auto-check passed
  • Draw

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants diagrams, flowcharts, architecture visuals, data relationships, timelines, concept maps, Mermaid, Graphviz, drawio, or polished paper figures generated…

    576 GitHub stars~1.3k tokensUpdated 12 days ago
    Auto-check: notes
  • Explore

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to survey a journal or field, fetch papers from OpenAlex, cluster topics, build exploration embeddings, or search named explore libraries under…

    576 GitHub stars~755 tokensUpdated 12 days ago
    Auto-check passed

Questions about Document

What does Document do?

A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…. Document is an agent skill from ZimoLiao/scholaraio. Use when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio document inspect.

When should I use Document?

Document fits situations like: the user wants to create; generate a downloadable Office deliverable; verify its structure and layout warnings with scholaraio document inspect.

How do I install Document in Claude Code?

Run `npx skills add ZimoLiao/scholaraio --skill document -a claude-code`. Or copy the skill folder (.claude/skills/document in ZimoLiao/scholaraio) into .claude/skills/document in your project. Claude Code loads it when a task matches its description.

How do I install Document in Codex?

Run `npx skills add ZimoLiao/scholaraio --skill document -a codex`. Or copy the skill folder (.claude/skills/document in ZimoLiao/scholaraio) into .agents/skills/document in your project. Codex loads it when a task matches its description.

Can I use Document in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZimoLiao/scholaraio --skill document -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/document, .gemini/skills/document, .github/skills/document and .opencode/skills/document in your project.

What does Document need to run?

SKILL.md names no scripts, command-line tools or credentials: Document is instructions for the agent only. Our summary lists: Python 3.

Does Document access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Document safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Document use?

Document is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Document use?

About 674 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Document?

Skills that share tags, products or a category with Document: Markitdown (ImCa0/just-laws, 781 stars), Docx4j (plutext/docx4j, 2.4k stars), Cyber Ppt (crazyykhllc-bit/CyberPPT, 1.8k stars) and Markit (shift-labs-ai/markit, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Document?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 576 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

Source: ZimoLiao/scholaraio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.