Skip to content
Skills Library
Science & research · Tool integration

setup

/setup

Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.

Repository
zotron ↗
Licence
AGPL-3.0
Last repository change
13.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
7
Deprecation

No signals detected. Repository changed on 13.07.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.

Original author description

Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.

How it works

  1. Goal
  2. Distribution model
  3. Procedure
  4. Mirror Controls
Original SKILL.md headings · 152 lines, 682 words
SKILL.md preview
---
name: setup
description: Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.
---

# Zotron Setup

Run this when the user has just installed the Zotron plugin or when `zotron ping` cannot reach Zotero.

## Goal

End state: `zotron ping` succeeds and the agent can call the single `zotron` CLI. OCR and RAG are subcommands: `zotron ocr ...` and `zotron rag ...`.

## Distribution model

The repository does not track `zotron.xpi`. New installs download the release XPI. If GitHub is unavailable, set `ZOTRON_XPI_URLS` to one or more mirror URLs. If a local file is already available, set `ZOTRON_XPI_PATH=/path/to/zotron.xpi`.

If Zotron is already installed but the setup target version is newer, do not reinstall from setup. Tell the user to use Zotero's native update flow:

```text
Tools -> Plugins -> Zotron -> gear icon -> Check for Updates -> restart Zotero
```

## Procedure

1. Check that the `zotron` CLI is installed. If missing, run the cascading install script below. It tries four methods in order and stops at the first success.

```bash
#!/usr/bin/env bash
set -euo pipefail

if command -v zotron >/dev/null 2>&1; then
  echo "zotron already installed: $(command -v zotron)"
  exit 0
fi

INSTALL_DIR="${HOME}/.local/bin"
mkdir -p "$INSTALL_DIR"

# --- Detect platform ---
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)
case "$ARCH" in aarch64|arm64) ARCH=arm64 ;; x86_64|amd64) ARCH=amd64 ;; esac
case "$OS" in
  linux)  PLATFORM="linux-${ARCH}" ;;
  darwin) PLATFORM="macos-${ARCH}" ;;
  *)      PLATFORM="windows-amd64.exe" ;;
esac
# Release binaries are versioned (zotron-<version>-<platform>), so resolve the
# latest tag first, then build the download URL for that exact asset.
# `|| true` + the empty check keep a failed/blocked API call (rate-limit,
# offline) from aborting the script under `set -e` — we just fall through to
# the other install methods below.
TAG=$(curl -fsSL https://api.github.com/repos/dianzuan/zotron/releases/latest 2>/dev/null \
        | grep -m1 '"tag_name"' | sed -E 's/.*"tag_name": *"([^"]+)".*/\1/' || true)
if [ -n "$TAG" ]; then
  GITHUB_URL="https://github.com/dianzuan/zotron/releases/download/${TAG}/zotron-${TAG#v}-${PLATFORM}"
else
  GITHUB_URL=""   # tag unresolved — skip the direct download, use fallbacks
fi

installed=false

# --- Method 1: cargo binstall (prebuilt binary via cargo-binstall) ---
if ! $installed && command -v cargo-binstall >/dev/null 2>&1; then
  echo "[1/4] Trying cargo binstall zotron ..."
  if cargo binstall zotron --no-confirm 2>/dev/null; then
    installed=true
  fi
fi

# --- Method 2: Direct download from GitHub Releases ---
if ! $installed; then
  echo "[2/4] Trying direct download from GitHub Releases ..."
  if curl -fL --connect-timeout 15 --max-time 120 -o "${INSTALL_DIR}/zotron" "$GITHUB_URL" 2>/dev/null; then
    chmod +x "${INSTALL_DIR}/zotron"
    installed=true
  fi
fi

# --- Method 3: Mirror fallback (for users behind GFW) ---
if ! $installed; then
  MIRRORS=(
    "https://gh-proxy.com/${GITHUB_URL}"
    "https://gh.llkk.cc/${GITHUB_URL}"
    "https://hub.gitmirror.com/${GITHUB_URL}"
  )
  for mirror in "${MIRRORS[@]}"; do
    echo "[3/4] Trying mirror: ${mirror%/*} ..."
    if curl -fL --connect-timeout 15 --max-time 120 -o "${INSTALL_DIR}/zotron" "$mirror" 2>/dev/null; then
      chmod +x "${INSTALL_DIR}/zotron"
      installed=true
      break
    fi
  done
fi

# --- Method 4: cargo install (compile from source, last resort) ---
if ! $installed && command -v cargo >/dev/null 2>&1; then
  echo "[4/4] Trying cargo install zotron (compiling from source) ..."
  if cargo install zotron 2>/dev/null; then
    installed=true
  fi
fi

if $installed; then
  echo "zotron installed successfully: $(command -v zotron || echo "${INSTALL_DIR}/zotron")"
else
  echo "ERROR: All install methods failed. Please install manually from:"
  echo "  ${GITHUB_URL}"
  exit 1
fi
```

Make sure `~/.local/bin` is on PATH. If not, add it: `export PATH="$HOME/.local/bin:$PATH"`

2. Run the setup script to verify and bootstrap the XPI.

```bash
PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
bash "$PLUGIN_ROOT/scripts/setup-zotron.sh"
```

3. If the bridge is live at the expected version, stop.

4. If the bridge is live but the plugin version is older, tell the user to update inside Zotero using the update flow above.

5. If the bridge is down, the script downloads or stages `zotron.xpi` into the user's real Downloads folder and prints the path as Zotero will see it.

6. Tell the user:

```text
In Zotero:
1. Tools -> Plugins
2. Gear icon -> Install Add-on From File
3. Choose zotron.xpi from the path printed by setup
4. Install, then restart Zotero
```

7. After restart, verify:

```bash
zotron ping
zotron system version
zotron --help  # should show all command groups
```

## Mirror Controls

```bash
ZOTRON_XPI_URLS='https://mirror.example/zotron.xpi https://github.com/dianzuan/zotron/releases/latest/download/zotron.xpi' \
  bash "$PLUGIN_ROOT/scripts/setup-zotron.sh"
```

Use `ZOTRON_XPI_PATH=/path/to/zotron.xpi` only when the file has already been downloaded through another channel.

Versions

RepositoryScoreLicence
This page · dianzuan/zotron100AGPL-3.0
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Database snapshot: 13.11.2026 · package version f7bfb31199a2 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100zotero
    Manage the user's Zotero library — search papers, add/organize items, export citations, OCR PDFs, and run semantic search (RAG). Use whenever the user mentions Zotero, "我的文献库", finding/adding/citing papers, "参考文献", "文献综述", or wants to read/extract content from their PDFs.…
  • 100zotero
    面向不同研究领域的 Zotero 技能:原文定位问答、全文翻译与精读、原生高亮和中文批注、双语 PDF/逐段 Markdown、论文证据对比表、综述与引用追踪;支持 OpenAlex / Crossref / 知网导出文件三种文献来源,术语和数字复核、可追溯纠错,另有归集分类、BibTeX 和草稿引用。用户提到 Zotero、解释论文、翻译、精读、标注、文献比较、综述、中文文献或知网时使用。
  • 100zotero-paper-fetching
    Full pipeline for batch literature search, PDF download, and Zotero intake. Use when the user provides a paper/citation list (Markdown numbered list, references excerpt, DOI list, arXiv IDs, etc.) and asks to "search, download, and file them into Zotero", "add these papers to…
  • 100zotero-cli
    Read and write a Zotero library from the shell with the `zotero-cli` command - search papers by keyword or meaning, read PDF full text and page ranges, get and set metadata, manage collections, tags, notes and annotations, add items by DOI/URL/ISBN, and export bibliographies.…
  • 90che-zotero-mcp
    Guide for using Zotero MCP tools to manage references, search academic papers, generate citations, and build knowledge graphs. Use when user asks about Zotero, citations, bibliography, literature review, academic search, or knowledge graph.
  • 100zotero-library
    Find, add and file papers in the user's Zotero library for the current project without changing anything the user already has. Use when a task needs the user's own papers, their PDFs' full text, citations from their library, or adding a paper to the project's reading list.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.