Agent skill

Publish

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site.

MITAuto-check passedDocuments & Office

Install Publish

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

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

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

At a glance

A skill your agent uses when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site.

  • Works in 3 steps: Confirm with the user that the… → Recommend a backup for important… → Never delete source files from…
  • The user says a paper
  • SKILL.md covers Architecture, Safety Gate, Archive Layout and Generate The Site, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Publish is an agent skill from ZimoLiao/scholaraio. Use when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site.

Its SKILL.md is about 730 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 Documents & Office, covering LaTeX and Peer review. It works with LaTeX. 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 says a paper
  • LaTeX deliverable is final and wants it archived under published/
  • Exposed through the static published-paper site

Example prompts

  • “/publish”

Workflow steps

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

  1. Confirm with the user that the deliverable is final enough to archive.
  2. Recommend a backup for important outputs, especially before replacing an existing archive directory.
  3. Never delete source files from workspace/; publishing is a copy/archive step.

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, json and yaml).

    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

Publish loads about 727 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 279 words of instructions outside code blocks.

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

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). 279 words, ~727 tokens.

Download SKILL.mdSave it as .claude/skills/publish/SKILL.md (or your agent's skills folder).
name
publish
description
Use when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site.

Published Paper Archive And Site Generation

Use this skill only after the user clearly says the deliverable is final, audited, or ready to publish. Drafts should stay under workspace/.

Architecture

The publishing workflow has three separate layers:

  • scholaraio/: upstream code and the scholaraio publish-site generator
  • published/: local audited deliverable archive, git-ignored by this repository
  • an optional separate GitHub Pages repository: generated static site files

Do not put user deliverables in the repository root except under published/, and do not commit published/ to the ScholarAIO repo.

Safety Gate

Before creating or changing a published archive:

  1. Confirm with the user that the deliverable is final enough to archive.
  2. Recommend a backup for important outputs, especially before replacing an existing archive directory.
  3. Never delete source files from workspace/; publishing is a copy/archive step.

Archive Layout

Use one folder per final deliverable:

text
published/<YYYY-MM-DD>-<short-title>/
├── metadata.json
├── main.pdf
├── main.tex
├── images/
└── misc/

Recommended metadata.json:

json
{
  "title": "Full title",
  "date": "YYYY-MM-DD",
  "keywords": ["keyword"],
  "subject": "field or topic",
  "pdf_filename": "main.pdf",
  "tex_files": ["main.tex"],
  "images_dir": "images",
  "misc_dir": "misc",
  "authors": ["Author", "Claude (AI Assistant)"],
  "note": "Final audited deliverable."
}

The site generator reads published/*/metadata.json, builds a source ZIP beside each archive, and writes a static site.

Generate The Site

Explicit output directory:

bash
scholaraio publish-site --out-dir ~/generated-report

Configured output directory:

yaml
publish:
  site_output_dir: ~/generated-report

Then:

bash
scholaraio publish-site

Default mode copies PDFs and source ZIPs into assets/papers/, producing a self-contained site suitable for a separate GitHub Pages repository.

Local preview mode uses symlinks instead of copying assets:

bash
scholaraio publish-site --out-dir ~/generated-report --symlink

Agent Behavior

  • Confirm the archive folder name and metadata before writing final archive files.
  • Keep metadata accurate: title, date, PDF filename, authors, subject, keywords, and note should match the actual deliverable.
  • After archiving, run scholaraio publish-site so the static site reflects the new item.
  • If the configured output directory is missing, either pass --out-dir or help the user set publish.site_output_dir.
  • Treat the generated site as deployable output; if it lives in another Git repo, ask before committing or pushing there.

© 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/publish of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

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

Publish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Publish this skillZimoLiao/scholaraio577—~727Automated safety check: PassMIT
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT
Mathmodel SkillhandsomeZR-netizen/mathmodel-skill292—~2.5kAutomated safety check: PassMIT
AI Review SkillNeuroDong/Ai-Review628—~2.5kAutomated safety check: PassMIT
Paper Revieweunomia-bpf/ActPlane104—~3.8kAutomated safety check: PassMIT
Paper Logiceunomia-bpf/ActPlane104—~5.7kAutomated safety check: PassMIT

Similar skills

  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed
  • AI Review Skill

    NeuroDong/Ai-Review

    Generates structured AI paper reviews (SoT style) for LaTeX, PDF, and Word manuscripts.

    628 GitHub stars~2.5k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Paper Review

    eunomia-bpf/ActPlane

    Review and fix academic writing in a LaTeX paper section. An agent skill from eunomia-bpf/ActPlane.

    104 GitHub stars~3.8k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Paper Logic

    eunomia-bpf/ActPlane

    Review a LaTeX paper for argument-level logic, cross-section consistency, and house style.

    104 GitHub stars~5.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Paper Audit

    brycewang-stanford/Auto-Empirical-Research-Skills

    Deep-review-first audit for Chinese and English academic papers across LaTeX, Typst, and PDF formats.

    4.6k GitHub stars~3.6k tokensUpdated 5 days ago
    Documents & OfficeAuto-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…

    577 GitHub stars~674 tokensUpdated 15 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…

    577 GitHub stars~827 tokensUpdated 15 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.

    577 GitHub stars~799 tokensUpdated 15 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…

    577 GitHub stars~1.4k tokensUpdated 15 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.

    577 GitHub stars~454 tokensUpdated 15 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…

    577 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check: notes

Works with

Questions about Publish

What does Publish do?

A skill your agent uses when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site. Publish is an agent skill from ZimoLiao/scholaraio. Use when the user says a paper, review, report, or LaTeX deliverable is final and wants it archived under published/ or exposed through the static published-paper site.

When should I use Publish?

Publish fits situations like: the user says a paper; laTeX deliverable is final and wants it archived under published/; exposed through the static published-paper site.

How do I install Publish in Claude Code?

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

How do I install Publish in Codex?

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

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

What does Publish need to run?

SKILL.md names no scripts, command-line tools or credentials: Publish is instructions for the agent only.

Does Publish 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 Publish 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 Publish use?

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

About 727 tokens (SKILL.md is roughly 2.9k 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 Publish?

Skills that share tags, products or a category with Publish: Paperjury (Spark-To-Paper-Skills/paperjury, 1.2k stars), Mathmodel Skill (handsomeZR-netizen/mathmodel-skill, 292 stars), AI Review Skill (NeuroDong/Ai-Review, 628 stars) and Paper Review (eunomia-bpf/ActPlane, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Publish?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 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.