New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Zotlit Pandoc

by aidenlx in aidenlx/zotlit

Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI.

AGPL-3.0Auto-check passedResearch & Science

Install Zotlit Pandoc

skills CLI
$ npx skills add aidenlx/zotlit --skill zotlit-pandoc -a claude-code

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

GitHub CLI
$ gh skill install aidenlx/zotlit zotlit-pandoc --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/aidenlx/zotlit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zotlit-pandoc .claude/skills/zotlit-pandoc && 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
zotlit-pandoc
GitHub stars
1k
Token cost
~1.2k tokens
SKILL.md length
681 words
Files
3
Skills in repo
16
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI.

  • Works in 3 steps: Run obsidian help zotlit and use only… → Target the vault that owns the input… → Run obsidian zotlit:pandoc-guide against…
  • A user wants native Pandoc to convert an Obsidian Markdown file through the ZotLit Pandoc Integration Pair
  • SKILL.md covers Start from the installed…, Select the workflow, Set up or refresh the pair and Run native Pandoc, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Zotlit Pandoc is an agent skill from aidenlx/zotlit. Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI. Use when a user wants native Pandoc to convert an Obsidian Markdown file through the ZotLit Pandoc Integration Pair. Requests for ZotLit's built-in Obsidian export belong to its built-in export command.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `agents/openai.yaml` and `evals/evals.json`).

It sits in Research & Science. It works with Pandoc and Obsidian. The repository describes itself as: Bring your Zotero library into Obsidian. Create literature notes, insert citations, and annotate PDFs without leaving your vault. The licence is AGPL-3.0.

When your agent uses it

  • A user wants native Pandoc to convert an Obsidian Markdown file through the ZotLit Pandoc Integration Pair

Example prompts

  • “/zotlit-pandoc”

Workflow steps

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

  1. Run obsidian help zotlit and use only the commands it reports.
  2. Target the vault that owns the input file. Put vault= before the command when the working directory does not select it unambiguously.
  3. Run obsidian zotlit:pandoc-guide against that vault. Treat this live guide as the source of truth for ZotLit commands, file names…

What it can do on your machine

Read from SKILL.md and the folder at commit 27f5752. 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.

    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

Zotlit Pandoc loads about 1.2k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 681 words of instructions outside code blocks.

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

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 aidenlx/zotlit at commit 27f5752, republished under its AGPL-3.0 licence (© aidenlx). 681 words, ~1,220 tokens.

Download SKILL.mdSave it as .claude/skills/zotlit-pandoc/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
zotlit-pandoc
description
Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI. Use when a user wants native Pandoc to convert an Obsidian Markdown file through the ZotLit Pandoc Integration Pair. Requests for ZotLit's built-in Obsidian export belong to its built-in export command.

ZotLit Native Pandoc Workflow

Start from the installed contract

Complete these steps before changing files, running Pandoc, or calling the resolver.

  1. Run obsidian help zotlit and use only the commands it reports.
  2. Target the vault that owns the input file. Put vault=<vault-name> before the command when the working directory does not select it unambiguously.
  3. Run obsidian zotlit:pandoc-guide against that vault. Treat this live guide as the source of truth for ZotLit commands, file names, compatibility floors, resolver responses, and error codes.

Read the guide again after a ZotLit update or when a saved integration pair might be stale.

This skill is written against Pandoc CLI Contract version 2 — the contractVersion the integration-files answer carries. When that answer reports another number, run zotlit:pandoc-guide again and follow the live guide over this skill.

Select the workflow

Match the user's goal to one path:

  • First setup: ask the user to select a user-owned workflow folder. Suggest a project-local folder when they have no preference.
  • Refresh: reuse the workflow folder the user supplies. Limit replacement to that authorized pair.
  • Export: use the existing workflow folder and a user-supplied CSL-JSON bibliography.
  • Diagnosis: reproduce or inspect the failed native run, then use the resolver only when its result can identify the fault.

The built-in Obsidian export command owns requests for export through ZotLit's managed Pandoc engine and user interface.

Set up or refresh the pair

  1. Retrieve the installed pair with the command named in the live guide.
  2. Record the reported plugin version in the final report.
  3. Compare both destination files byte for byte.
  4. When either file differs, stage both returned files and replace both destination files as one pair. Preserve the prior pair until both staged files are ready.
  5. Keep user Pandoc options on the command line or in a separate user-owned defaults file.

For a first setup, explain the selected folder and replacement plan before writing. For a refresh, leave every copy outside the supplied workflow folder unchanged.

Show full SKILL.md (350 more words)Show less

Run native Pandoc

Reuse a CSL-JSON bibliography the user supplies. Validate that it is readable JSON before starting Pandoc. When the user needs a bibliography, recommend Better BibTeX CSL-JSON auto-export for automatic refresh and accept a manual Zotero CSL JSON export. Treat the bibliography as user-owned input: ZotLit supplies Citation Keys to Pandoc and leaves bibliography creation to Zotero.

zotlit-csl is ZotLit-resolved; csl and --csl are Pandoc-owned. The live guide defines the cases. When a document carries both, identify the conflict to the user and ask which input to keep before running Pandoc.

Native exports inherit lang from the document. The vault Citation Locale applies to in-app rendering and built-in export only.

Use the minimal invocation from the live guide. Quote every user-selected path. Configure the run so a Citation Key missing from the bibliography stops the export. Write to a unique staged output beside the requested output. In a normal export, the Lua filter handles citation and style resolution.

Publish the requested output only after Pandoc exits successfully and the staged file is non-empty. Confirm replacement when the requested output already exists. A failed run leaves the requested output unchanged and removes its staged file.

Diagnose a failed run

  1. Read the native Pandoc error and confirm which input, workflow folder, bibliography, and output path were used.
  2. Confirm that the saved pair matches the current response from the installed plugin.
  3. Route by error type:
    • Style-related error: call zotlit:csl directly and interpret the response through the guide's error definitions.
    • Citation-related error: call zotlit:resolve directly and interpret the response through the guide's error definitions. Compare resolved Citation Keys against the supplied bibliography before retrying.

When resolved keys are absent from the bibliography, name every missing key and ask the user for a refreshed Better BibTeX CSL-JSON auto-export or a new manual Zotero CSL JSON export. Preserve the supplied bibliography until the user authorizes a replacement.

When the resolver reports a note or citation-intent error, name the source link and the matching guide error. Ask the user to correct that source note; retry only after the input change is authorized.

© aidenlx, AGPL-3.0. 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 2 other files in skills/zotlit-pandoc of aidenlx/zotlit.

  • SKILL.md
  • agents/openai.yaml
  • evals/evals.json

Open the folder on GitHubat commit 27f5752

Compare with similar skills

Zotlit Pandoc 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.

Zotlit Pandoc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zotlit Pandoc this skillaidenlx/zotlit1k—~1.2kAutomated safety check: PassAGPL-3.0
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Paper Glossary917Dhj/DeepPaperNote1.2k1 repos~1.5kAutomated safety check: PassMIT
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template1.1k—~1kAutomated safety check: PassNone
Deeppapernote917Dhj/DeepPaperNote1.2k1 repos~5.9kAutomated safety check: PassMIT
Conference Paper Recommenderjuliye2025/evil-read-arxiv1.7k—~2.5kAutomated safety check: PassNone

Similar skills

  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Paper Glossary

    917Dhj/DeepPaperNote

    A skill your agent uses when building reusable Obsidian glossary notes from an existing paper source manifest, optionally with a raw-sections override, especially when a reader needs a reviewed…

    1.2k GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed

  • Pandoc DOCX Template

    Achuan-2/pandoc_docx_template

    A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…

    1.1k GitHub stars~1k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed

  • Deeppapernote

    917Dhj/DeepPaperNote

    Generate a high-quality deep-reading note for a single paper and write it into an Obsidian-style vault.

    1.2k GitHub starsUsed in 1 repo~5.9k tokens
    Research & ScienceAuto-check passed

  • Conference Paper Recommender

    juliye2025/evil-read-arxiv

    Searches DBLP for papers from top conferences such as CVPR, ICLR and NeurIPS, adds Semantic Scholar data, scores them and writes a yearly Obsidian note.

    1.7k GitHub stars~2.5k tokensUpdated 26 days ago
    Research & ScienceAuto-check passed

  • Research Lit

    CurryTang/Amadeus

    Search and analyze research papers, find related work, summarize key ideas.

    176 GitHub starsUsed in 5 repos~963 tokens
    Research & ScienceAuto-check: notes

More from aidenlx/zotlit

All 16 skills in this repo

  • I18n UI Text

    aidenlx/zotlit

    Obsidian house style for the wording of user-facing UI strings — command names, setting labels, button text, notices, modal copy.

    1k GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

  • Obsidian CSS

    aidenlx/zotlit

    Style Obsidian plugin UI with Tailwind + native components. An agent skill from aidenlx/zotlit.

    1k GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed

  • Arkregex

    aidenlx/zotlit

    Typed regex authoring with arkregex in this repo. An agent skill from aidenlx/zotlit.

    1k GitHub stars~952 tokensUpdated yesterday
    Auto-check passed

  • Changelog Entry

    aidenlx/zotlit

    Write a user-facing changelog entry under apps/docs/content/changelog/.

    1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed

  • Discord Announcement

    aidenlx/zotlit

    Draft a Discord announcement from a changelog entry. An agent skill from aidenlx/zotlit.

    1k GitHub stars~604 tokensUpdated yesterday
    Auto-check passed

  • Inlang I18n

    aidenlx/zotlit

    Define ZotLit UI messages in the Inlang Message Format and consume them through the generated JSON Language Pack facade.

    1k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Zotlit Pandoc

What does Zotlit Pandoc do?

Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI. Zotlit Pandoc is an agent skill from aidenlx/zotlit. Set up, refresh, run, and diagnose ZotLit's Native Pandoc Workflow with a user-installed Pandoc CLI.

When should I use Zotlit Pandoc?

Zotlit Pandoc fits situations like: A user wants native Pandoc to convert an Obsidian Markdown file through the ZotLit Pandoc Integration Pair.

How do I install Zotlit Pandoc in Claude Code?

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

How do I install Zotlit Pandoc in Codex?

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

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

What does Zotlit Pandoc need to run?

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

Does Zotlit Pandoc 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 Zotlit Pandoc 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 Zotlit Pandoc use?

Zotlit Pandoc is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zotlit Pandoc use?

About 1.2k tokens (SKILL.md is roughly 4.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 Zotlit Pandoc?

Skills that share tags, products or a category with Zotlit Pandoc: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Paper Glossary (917Dhj/DeepPaperNote, 1.2k stars), Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars) and Deeppapernote (917Dhj/DeepPaperNote, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zotlit Pandoc?

aidenlx (a GitHub user) maintains it in aidenlx/zotlit, which has 1,029 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 2026.

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