Skip to content

/econ-review-setup

Prepares, verifies, repairs, or removes the user-owned Python runtime and local Review Desk behind an installed econ-review plugin — dry-run shown first, no silent package downloads or system-software installs.

Category: infra
Field: economics
License: PolyForm-Noncommercial-1.0.0 (econ-review); MIT (econ-slides, econ-write)
Updated: 2026-07
Stages: —

Set up Econ Review

Resolve PLUGIN_ROOT as the parent directory of the skills/ directory that contains this setup skill. Use the standard-library setup tool at PLUGIN_ROOT/scripts/setup_econ_review.py. Do not copy the skill into an agent home: marketplace installation already supplies it.

  1. Find a working Python 3.10 or newer command with venv and pip bootstrapping support already on the machine. Do not install Python, a package manager, a missing python3-venv component, or system software on your own.
  2. Choose global support setup unless the user explicitly requests one-project state. For global setup, run this exact operation first with --dry-run:
Text Only
PYTHON PLUGIN_ROOT/scripts/setup_econ_review.py --support-only --global --with-review-desk --dry-run

For project state, replace --global with --local PROJECT_DIRECTORY. 3. Summarize the dry run in plain language. State that applying it creates or refreshes a private econ-review virtual environment, may download the version-constrained Python packages declared by the plugin, and installs the already bundled, manifest-verified Review Desk. It does not install a second skill copy, use administrator access, or upload a manuscript. 4. Apply the same command without --dry-run only when the user has explicitly asked to install, finish, repair, or refresh setup, or confirms after seeing the plan. Do not treat a request merely to review a paper as authorization to download packages or change user-level state. 5. Preserve the setup tool's exit distinction. Exit 0 means the core runtime, PDF ingestion, and requested Review Desk passed. Exit 2 means the managed runtime and Review Desk may be ready but PDF ingestion is still incomplete, normally because Poppler is absent. Do not call that a failed plugin install. 6. Never install Poppler, Tesseract, TeX, Pandoc, Node.js, an optional PDF backend, or any administrator-managed package automatically. If Poppler is missing, report the setup tool's platform-specific user-level options and ask separately before running a package-manager command. 7. Verify runtime discovery without changing files:

Text Only
PYTHON PLUGIN_ROOT/scripts/setup_econ_review.py --runtime-path

After project-only setup, pass the same project scope instead:

Text Only
PYTHON PLUGIN_ROOT/scripts/setup_econ_review.py --runtime-path --local PROJECT_DIRECTORY

This read-only resolver verifies and prints only the managed interpreter. Preserve the setup command's earlier PDF-doctor result and Review Desk launch command or URL when reporting overall readiness. Never expose package-index credentials or environment-secret values in the response.

  1. When the user asks to uninstall support data, show --cleanup-support --global --dry-run (or the matching --local scope) first. Apply the same scope with --confirm-cleanup only after explicit confirmation. Explain that plugin removal alone retains the runtime, descriptor, and Review Desk, while cleanup leaves the plugin and any direct skill copy unchanged.