Deeppapernote
917Dhj/DeepPaperNote
Generate a high-quality deep-reading note for a single paper and write it into an Obsidian-style vault.
Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken.
Install Zotlit Citations
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install aidenlx/zotlit zotlit-citations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zotlit-citations .claude/skills/zotlit-citations && rm -rf skills-srcUse ~/.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/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .claude/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install aidenlx/zotlit zotlit-citations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/zotlit-citations .agents/skills/zotlit-citations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .agents/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install aidenlx/zotlit zotlit-citations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/zotlit-citations .cursor/skills/zotlit-citations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .cursor/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/aidenlx/zotlit.git --path skills/zotlit-citations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install aidenlx/zotlit zotlit-citations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/zotlit-citations .gemini/skills/zotlit-citations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .gemini/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install aidenlx/zotlit zotlit-citationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/zotlit-citations .github/skills/zotlit-citations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .github/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aidenlx/zotlit --skill zotlit-citations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install aidenlx/zotlit zotlit-citations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aidenlx/zotlit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/zotlit-citations .opencode/skills/zotlit-citations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "zotlit-citations" agent skill from https://github.com/aidenlx/zotlit/tree/main/skills/zotlit-citations into .opencode/skills/zotlit-citations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotlit-citations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
zotlit-citations- GitHub stars
- 1k
- Token cost
- ~1k tokens
- SKILL.md length
- 620 words
- Files
- 2
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken.
- Works in 3 steps: obsidian help zotlit — use only the… → obsidian zotlit:citations-guide — the… → obsidian zotlit:template-status — read…
- A user asks who cites something
- SKILL.md covers Start, Target one vault and one…, Choose the selector and Read context from positions, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Zotlit Citations is an agent skill from aidenlx/zotlit. Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken. Use whenever a user asks who cites something, what a note references, where a work is discussed, or why a citation does not resolve.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It sits in Research & Science, covering Citation management. It works with Obsidian and Zotero. 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 asks who cites something
- What a note references
- Where a work is discussed
- Why a citation does not resolve
Example prompts
- “/zotlit-citations”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- obsidian help zotlit — use only the commands and parameters it reports; commands reject what they do not declare.
- obsidian zotlit:citations-guide — the installed version's field semantics and workflow.
- obsidian zotlit:template-status — read identity.source.id from its answer, then pass expect-source= on every later call.
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 (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
Zotlit Citations loads about 1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 620 words of instructions outside code blocks.
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). 620 words, ~1,041 tokens.
Download SKILL.mdSave it as
.claude/skills/zotlit-citations/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- zotlit-citations
- description
- Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken. Use whenever a user asks who cites something, what a note references, where a work is discussed, or why a citation does not resolve.
ZotLit citations
Start
Complete these steps in order before you answer a citation question.
obsidian help zotlit— use only the commands and parameters it reports; commands reject what they do not declare.obsidian zotlit:citations-guide— the installed version's field semantics and workflow.obsidian zotlit:template-status— readidentity.source.idfrom its answer, then passexpect-source=<source-id>on every later call.
Read the guide again after a ZotLit update.
This skill is written against citations CLI Contract version 3 — the contractVersion a cited-by or references answer carries. When an answer reports another number, run zotlit:citations-guide again and follow the live guide over this skill. Step 3 belongs to another namespace: zotlit:template-status reports the Template Workbench's own contract version, which moves on its own.
Target one vault and one Zotero library
Put vault=<vault-name> first when the working directory does not select the vault unambiguously:
obsidian vault=MyVault zotlit:citations-guideobsidian vault shows the active vault, obsidian vaults lists all known vaults. Confirm identity.vault once, then keep the same prefix.
Keep expect-source= on every call rather than trusting the library to stay connected. A user with more than one Zotero profile gets a wrong answer, not an error, when it is left off.
Choose the selector
Ask the vault, never the filesystem: a text search over the vault misses the citation-key resolution, the user's citation-source choices, and the wikilink rules the index applies. Match the question to one selector:
- A work the user names by its Zotero key — query by key.
- A work the user names by a citation key they saw in text, such as
@doe2020— query by citation key, with no lookup step first. - A work the user points at through a Literature Note — take the Zotero key from that note, then query by key.
- A work the user names only in prose — ask which item they mean, or ask them to point at the note. Do not guess an item.
- A document — query its references by its vault path. Ask this of the user's own writing as readily as of a Literature Note.
Read context from positions
The answers report where each citation is, not what surrounds it. When the user needs context:
- Open the reported path.
- Read the file at the reported position.
- Widen to the sentence, paragraph, or section the question needs.
Quote the file you read, and name the note it came from. Never present text as something a command returned.
Show full SKILL.md (220 more words)Show less
Diagnose broken citations
Run the document's references, then group the entries by kind and turn each broken kind into the one correction its user can make — a citation key to fix in the note, or a work to add to Zotero.
Every such fix edits the user's writing or their Zotero library. Propose each change and wait for the user to accept it.
Report what the answer is worth
Read omittedSyntaxes before you report any answer. An empty list means the answer is whole. When it names a syntax, say the answer is short — this note or work carries citations written that way and the answer leaves them out — and name the setting the guide gives for that syntax. Leave the change to the user.
When the payload reports a degraded index state, give the answer and say plainly that it may be incomplete. When a call fails, follow the recovery action in diagnostic.hint before you retry, and tell the user what you changed.
Tone
Use plain language and name each step in everyday terms ("let me check which notes cite this paper"). Report notes by their path or title and works by their summary; add a Zotero key only when the user needs it for another command. Introduce a term such as citation key once, then use it freely.
© 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 1 other file in skills/zotlit-citations of aidenlx/zotlit.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit 27f5752
Compare with similar skills
Zotlit Citations 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Zotlit Citations this skillaidenlx/zotlit | 1k | — | ~1k | Automated safety check: Pass | AGPL-3.0 | |
| Deeppapernote917Dhj/DeepPaperNote | 1.2k | 1 repos | ~5.9k | Automated safety check: Pass | MIT | |
| Zotero Taxonomy Curatorganzoth/zotero-taxonomy-curator | 160 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Obsidian Paper VaultAperivue/medsci-skills | 331 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Zotero Obsidian BridgeGalaxy-Dawn/claude-scholar | 5.7k | — | ~514 | Automated safety check: Pass | MIT | |
| Lit SyncAperivue/medsci-skills | 331 | — | ~4.6k | Automated safety check: Pass | MIT |
Similar skills
Zotero Taxonomy Curator
ganzoth/zotero-taxonomy-curator
Domain-configurable Zotero-to-Obsidian literature curation and paper close-reading skill.
Obsidian Paper Vault
Aperivue/medsci-skills
A skill your agent uses when turning a folder of research PDFs into Obsidian notes, even if Obsidian is not named.
Zotero Obsidian Bridge
Galaxy-Dawn/claude-scholar
Moves papers from Zotero into an Obsidian project knowledge base as source notes, literature synthesis and writing outputs, with evidence records behind every promoted claim.
Lit Sync
Aperivue/medsci-skills
A skill your agent uses when references in a .bib file (often from /search-lit) should land in Zotero and Obsidian.
Comm Lit Review Claude Single
AI4Scientist/nano-scientist
Communications-domain literature review with Claude-style knowledge-base-first retrieval.
More from aidenlx/zotlit
All 16 skills in this repoI18n UI Text
aidenlx/zotlit
Obsidian house style for the wording of user-facing UI strings — command names, setting labels, button text, notices, modal copy.
Obsidian CSS
aidenlx/zotlit
Style Obsidian plugin UI with Tailwind + native components. An agent skill from aidenlx/zotlit.
Arkregex
aidenlx/zotlit
Typed regex authoring with arkregex in this repo. An agent skill from aidenlx/zotlit.
Changelog Entry
aidenlx/zotlit
Write a user-facing changelog entry under apps/docs/content/changelog/.
Discord Announcement
aidenlx/zotlit
Draft a Discord announcement from a changelog entry. An agent skill from aidenlx/zotlit.
Inlang I18n
aidenlx/zotlit
Define ZotLit UI messages in the Inlang Message Format and consume them through the generated JSON Language Pack facade.
Related
Categories
Questions about Zotlit Citations
What does Zotlit Citations do?
Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken. Zotlit Citations is an agent skill from aidenlx/zotlit. Answer citation questions about an Obsidian vault through ZotLit: which notes cite a work, what a document cites, and why a citation is broken.
When should I use Zotlit Citations?
Zotlit Citations fits situations like: A user asks who cites something; what a note references; where a work is discussed; why a citation does not resolve.
How do I install Zotlit Citations in Claude Code?
Run `npx skills add aidenlx/zotlit --skill zotlit-citations -a claude-code`. Or copy the skill folder (skills/zotlit-citations in aidenlx/zotlit) into .claude/skills/zotlit-citations in your project. Claude Code loads it when a task matches its description.
How do I install Zotlit Citations in Codex?
Run `npx skills add aidenlx/zotlit --skill zotlit-citations -a codex`. Or copy the skill folder (skills/zotlit-citations in aidenlx/zotlit) into .agents/skills/zotlit-citations in your project. Codex loads it when a task matches its description.
Can I use Zotlit Citations 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-citations -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-citations, .gemini/skills/zotlit-citations, .github/skills/zotlit-citations and .opencode/skills/zotlit-citations in your project.
What does Zotlit Citations need to run?
SKILL.md names no scripts, command-line tools or credentials: Zotlit Citations is instructions for the agent only.
Does Zotlit Citations 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 Citations 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 Citations use?
Zotlit Citations 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 Citations use?
About 1k tokens (SKILL.md is roughly 4.2k 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 Citations?
Skills that share tags, products or a category with Zotlit Citations: Deeppapernote (917Dhj/DeepPaperNote, 1.2k stars), Zotero Taxonomy Curator (ganzoth/zotero-taxonomy-curator, 160 stars), Obsidian Paper Vault (Aperivue/medsci-skills, 331 stars) and Zotero Obsidian Bridge (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Zotlit Citations?
aidenlx (a GitHub user) maintains it in aidenlx/zotlit, which has 1,028 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 9, 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.