Agent skill

Export

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing.

MITAuto-check passedResearch & Science

Install Export

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

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

GitHub CLI
$ gh skill install ZimoLiao/scholaraio export --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/export .claude/skills/export && 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
export
GitHub stars
576
Token cost
~1.6k tokens
SKILL.md length
252 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing.

  • Works in 4 steps: 检查是否已有缓存 → 获取期刊官方格式说明 → 写 Python 格式化函数并保存 → …
  • The user needs BibTeX
  • SKILL.md covers 支持的导出格式, BibTeX 导出, RIS 导出(Zotero / Endnote /… and Markdown 文献列表导出, plus 3 more sections
  • Calls pip; reaches raw.githubusercontent.com and github.com

What it does

Export is an agent skill from ZimoLiao/scholaraio. Use when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Citation management and Word documents. It works with LaTeX, Microsoft Word and Zotero. 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 needs BibTeX
  • Markdown reference lists
  • Filtered citation exports
  • Custom citation styles

Example prompts

  • “/export”

Requirements

  • Python 3

Workflow steps

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

  1. 检查是否已有缓存
  2. 获取期刊官方格式说明
  3. 写 Python 格式化函数并保存
  4. 导出

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

    Shell commands in SKILL.md call:

    • pip

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com
    • github.com
    • publishing.aip.org

    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

Export loads about 1.6k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 252 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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). 252 words, ~1,588 tokens.

Download SKILL.mdSave it as .claude/skills/export/SKILL.md (or your agent's skills folder).
name
export
description
Use when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing.

导出论文与文档

将本地论文库导出为标准引用格式,或将任意 Markdown 内容转换为 Word 文件。

支持的导出格式

格式命令用途
BibTeX .bibexport bibtexLaTeX 写作引用
RIS .risexport risZotero / Endnote / Mendeley 导入
Markdown 文献列表export markdown直接粘贴到文档、综述草稿
Word DOCXexport docx分享给同事、导师,任意 Markdown 内容

BibTeX 导出

bash
# 导出全部论文到屏幕
scholaraio export bibtex --all

# 导出全部论文到文件
scholaraio export bibtex --all -o workspace/library.bib

# 导出指定论文
scholaraio export bibtex "Smith-2023-Turbulence" "Doe-2024-DNS"

# 按年份筛选导出
scholaraio export bibtex --all --year 2020-2024 -o workspace/recent.bib

# 按期刊筛选导出
scholaraio export bibtex --all --journal "Fluid Mechanics" -o workspace/jfm.bib

RIS 导出(Zotero / Endnote / Mendeley)

bash
# 导出全部论文
scholaraio export ris --all -o workspace/library.ris

# 导出指定论文
scholaraio export ris "Smith-2023-Turbulence" "Doe-2024-DNS" -o workspace/refs.ris

# 按年份筛选
scholaraio export ris --all --year 2022-2024 -o workspace/recent.ris

导出后可直接在 Zotero 中:File → Import → 选择 .ris 文件

Markdown 文献列表导出

内置格式(--style)
格式名说明典型场景
apa(默认)APA 7th 作者-年份社科、心理、教育
vancouverVancouver/ICMJE 编号医学、生命科学
chicago-author-dateChicago 17 作者-年份人文、社科
mlaMLA 9th文学、语言学
<自定义>期刊专属格式见下方「自定义格式」
bash
# 导出全部论文(APA 风格,默认)
scholaraio export markdown --all

# 指定引用格式
scholaraio export markdown --all --style vancouver
scholaraio export markdown --all --style chicago-author-date
scholaraio export markdown --all --style jcp        # 自定义格式

# 导出到文件
scholaraio export markdown --all --style apa -o workspace/references.md

# 无序列表
scholaraio export markdown --all --bullet

# 按年份筛选
scholaraio export markdown --all --year 2020-2024 -o workspace/recent_refs.md
查看可用格式
bash
scholaraio style list           # 列出全部格式(内置 + 自定义)
scholaraio style show jcp       # 查看某个自定义格式的代码

自定义期刊引用格式(Agent 精确控制)

原理

自定义格式以 Python 文件存储在配置的 citation styles 目录中。fresh 默认是 data/libraries/citation_styles/<name>.py。如果用户仍有旧版 data/citation_styles/ 内容,先通过 scholaraio migrate upgrade --migration-id <id> --confirm 迁移后再导出。格式文件必须实现一个函数:

python
def format_ref(meta: dict, idx: int | None = None) -> str:
    """
    meta 字段:title, authors (list), year, journal, volume, issue,
               pages, doi, publisher, paper_type, ...
    idx:  有序列表的编号(None = 无序/bullet)
    返回:格式化后的 Markdown 引用字符串
    """
Agent 工作流:为指定期刊生成格式

当用户说「导出成 JCP 格式」「帮我按 Physical Review Letters 格式导出」:

  1. 检查是否已有缓存

    bash
    scholaraio style list

    如果已有 jcp 或目标格式名,直接跳到第 4 步。

  2. 获取期刊官方格式说明

    • 搜索:<journal name> citation style guide 或 <journal name> reference format
    • 或从 CSL 仓库获取标准定义: https://raw.githubusercontent.com/citation-style-language/styles/master/<slug>.csl
    • CSL 搜索:https://github.com/citation-style-language/styles/(支持 10,000+ 期刊)
  3. 写 Python 格式化函数并保存

    • 根据格式说明写 format_ref(meta, idx) 函数
    • 保存到当前 cfg.citation_styles_dir / "<name>.py"(fresh 默认 data/libraries/citation_styles/<name>.py)
    • 可同时保存同目录的 <name>.json(记录来源和示例)
  4. 导出

    bash
    scholaraio export markdown --all --style <name> -o workspace/refs.md
示例:JCP 格式文件(fresh 默认 data/libraries/citation_styles/jcp.py)
python
# Journal of Chemical Physics / AIP Publishing 编号格式
# 来源:https://publishing.aip.org/wp-content/uploads/2021/05/JCP_Style_Guide.pdf

def format_ref(meta: dict, idx: int | None = None) -> str:
    authors = meta.get("authors") or []

    def _fmt(name):
        parts = name.split(",", 1)
        if len(parts) == 2:
            last, first = parts[0].strip(), parts[1].strip()
            initials = " ".join(f"{w[0]}." for w in first.split() if w)
            return f"{initials} {last}"
        return name

    if len(authors) == 1:
        author_str = _fmt(authors[0])
    elif len(authors) <= 3:
        fmt = [_fmt(a) for a in authors]
        author_str = ", ".join(fmt[:-1]) + f", and {fmt[-1]}"
    elif authors:
        author_str = _fmt(authors[0]) + " et al."
    else:
        author_str = "Unknown"

    title   = meta.get("title") or "Untitled"
    journal = meta.get("journal") or ""
    volume  = meta.get("volume") or ""
    pages   = meta.get("pages") or ""
    year    = meta.get("year") or "n.d."
    doi     = meta.get("doi") or ""
    start_page = pages.split("-")[0].strip() if pages else ""

    ref = f'{author_str}, "{title},"'
    if journal: ref += f" *{journal}*"
    if volume:  ref += f" **{volume}**,"
    if start_page: ref += f" {start_page}"
    ref += f" ({year})."
    if doi: ref += f" doi:{doi}"

    prefix = f"{idx}. " if idx is not None else "- "
    return prefix + ref

输出示例:

1. A. Vaswani et al., "Attention Is All You Need," *Advances in Neural Information Processing Systems* **30**, 5998 (2017). doi:10.48550/arXiv.1706.03762

DOCX 导出(任意 Markdown → Word)

bash
# 将 Markdown 文件导出为 Word
scholaraio export docx --input workspace/literature_review.md --output workspace/review.docx

# 添加文档标题
scholaraio export docx --input workspace/report.md --output workspace/report.docx --title "研究报告"

# 从 stdin 读取(配合 Claude 生成内容直接导出)
echo "# 标题\n内容..." | scholaraio export docx --output workspace/doc.docx

支持的 Markdown 元素:标题(H1-H9)、段落、粗体、斜体、列表、表格、代码块、引用块

依赖:需安装 pip install python-docx

高级排版:export docx 仅做简单 Markdown → Word 转换。需要自定义样式、嵌入图片、表格等高级排版时,请使用 /document skill(直接调用 python-docx API)。


示例

用户说:"把我所有论文导出成 BibTeX" → 执行 export bibtex --all

用户说:"导出成 RIS,我要导入 Zotero" → 执行 export ris --all -o workspace/library.ris

用户说:"给我一份 Markdown 格式的参考文献列表" → 执行 export markdown --all

用户说:"按 Vancouver 格式导出文献列表" → 执行 export markdown --all --style vancouver

用户说:"按 JCP 格式导出,我要投 Journal of Chemical Physics" → 先 style list 检查,若无则获取 JCP 格式说明、写入当前 citation styles 目录(fresh 默认 data/libraries/citation_styles/jcp.py),再 export markdown --all --style jcp

用户说:"把这篇文献综述导出成 Word 文件" → 执行 export docx --input workspace/review.md --output workspace/review.docx

用户说:"导出 DNS 相关的论文引用" → 先用 usearch "DNS" 搜索,从结果中提取目录名,再 export markdown <dir1> <dir2> ...

© 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

Just SKILL.md in .claude/skills/export of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

Export 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.

Export compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Export this skillZimoLiao/scholaraio576—~1.6kAutomated safety check: PassMIT
Latex To Word Workflowhajimi-kun/latex-to-word-workflow128—~2.3kAutomated safety check: PassMIT
Scipilot Cite Skillfranklee16/academic-research-skills223—~1.9kAutomated safety check: PassMIT
CLI Anything ZoteroPiaoyangGuohai1/cli-anything-zotero137—~2.6kAutomated safety check: PassApache-2.0
Manage RefsAperivue/medsci-skills329—~4.1kAutomated safety check: PassMIT
Academic Paperbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~7.3kAutomated safety check: PassCustom licence

Similar skills

  • Latex To Word Workflow

    hajimi-kun/latex-to-word-workflow

    Load when the user asks to convert an academic LaTeX manuscript, thesis, or report into an editable Word DOCX, adapt it to a Word template, preserve citations or cross-references, or diagnose a…

    128 GitHub stars~2.3k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Scipilot Cite Skill

    franklee16/academic-research-skills

    SciPilot Skills 家族的文献检索与引用插入技能。支持两种输入模式—— 模式 A:读取用户的 Word(.docx) 或 LaTeX(.tex) 论文,在正文对应章节插入引用; 模式 B:接收用户给出的一段话/一个观点/一个论断,输出能支撑它的参考文献列表 (不修改文档)。两种模式都通过 Semantic Scholar、OpenAlex、Crossref 三源…

    223 GitHub stars~1.9k tokensUpdated 20 days ago
    Research & ScienceAuto-check passed
  • CLI Anything Zotero

    PiaoyangGuohai1/cli-anything-zotero

    Full-featured CLI for Zotero reference management. An agent skill from PiaoyangGuohai1/cli-anything-zotero.

    137 GitHub stars~2.6k tokensUpdated 2 mo ago
    Research & ScienceAuto-check passed
  • Manage Refs

    Aperivue/medsci-skills

    A skill your agent uses when references must be written, rendered or converted.

    329 GitHub stars~4.1k tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Academic Paper

    brycewang-stanford/Auto-Empirical-Research-Skills

    Academic paper writing skill with 12-agent pipeline. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.5k GitHub stars~7.3k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Format References Zotero

    aipoch/medical-research-skills

    Zotero reference formatting workflow. An agent skill from aipoch/medical-research-skills.

    2k GitHub stars~1.9k tokensUpdated 21 days ago
    Research & ScienceAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Document

    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…

    576 GitHub stars~674 tokensUpdated 13 days ago
    Auto-check passed
  • 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 13 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 13 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 13 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 13 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 13 days ago
    Auto-check: notes

Questions about Export

What does Export do?

A skill your agent uses when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing. Export is an agent skill from ZimoLiao/scholaraio. Use when the user needs BibTeX, RIS, Markdown reference lists, filtered citation exports, custom citation styles, or a Markdown-to-DOCX export for sharing.

When should I use Export?

Export fits situations like: the user needs BibTeX; markdown reference lists; filtered citation exports; custom citation styles.

How do I install Export in Claude Code?

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

How do I install Export in Codex?

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

Can I use Export 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 export -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/export, .gemini/skills/export, .github/skills/export and .opencode/skills/export in your project.

What does Export need to run?

Going by SKILL.md and its folder, Export needs the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does Export access the network?

SKILL.md names 3 domains. In commands or code: raw.githubusercontent.com, github.com and publishing.aip.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Export 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 Export use?

Export 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 Export use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Export?

Skills that share tags, products or a category with Export: Latex To Word Workflow (hajimi-kun/latex-to-word-workflow, 128 stars), Scipilot Cite Skill (franklee16/academic-research-skills, 223 stars), CLI Anything Zotero (PiaoyangGuohai1/cli-anything-zotero, 137 stars) and Manage Refs (Aperivue/medsci-skills, 329 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Export?

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.