mcpField
P
paper-spine-update

paper-spine-update

github.com/wubing2023Agent workflows6.1k209 installsUpdated 2w ago
Repository

About paper-spine-update

paper-spine-update is an updater for users maintaining PaperSpine skills in Codex, Claude Code, or OpenClaw. It checks GitHub's version manifest and updates the local suite while preserving PaperSpine settings and project artifacts.

Key features

  1. 01Check for available updates
  2. 02Update supported PaperSpine installs
  3. 03Preserve global configuration
  4. 04Leave project artifacts untouched

Use cases

  1. 01Check whether PaperSpine is current
  2. 02Upgrade PaperSpine across installed hosts
  3. 03Reinstall the local suite from GitHub

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-update

After installing, type/paper-spine-updatein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

paperspine_version.json
agents/
openai.yaml
scripts/
_paper_spine_utils.py
humanize_check.py
paperspine_update.py

Details

From the project README

PaperSpine Update

Use this skill when the user asks to update PaperSpine, check whether PaperSpine is the latest version, reinstall the local suite from GitHub, or upgrade the local Codex, Claude Code, or OpenClaw PaperSpine skills while preserving settings.

Required Behavior

Run the bundled updater using the full path to the installed skill:

Windows:

$script = Join-Path $env:USERPROFILE ".claude\skills\paper-spine-update\scripts\paperspine_update.py"
python $script --yes

macOS / Linux:

python3 ~/.claude/skills/paper-spine-update/scripts/paperspine_update.py --yes

For a version check only, use --check-only instead of --yes.

The updater must:

  • read the local install state from ~/.paperspine/install_state.json when present,
  • fall back to this skill's bundled paperspine_version.json when install state is missing,
  • compare against the GitHub main manifest at dist/paperspine_version.json,
  • update Codex, Claude Code, and OpenClaw installs by default,
  • preserve ~/.paperspine/config.json, including UI language preferences,
  • never touch project artifacts such as paper_rewriting_output/,
  • print a clear already-latest message when no update is needed,
  • after installing or updating, remove any stale skillOverrides entries for PaperSpine skills (the sync script does this automatically).

Advanced Usage

  • Use --target codex, --target claude, or --target openclaw only when the user explicitly asks to update one host.
  • Use --repo-archive <path-or-url> for local testing or offline update from a downloaded PaperSpine archive.
  • Use --config-home <path> only for tests or when the user has explicitly configured a non-default PaperSpine global config directory.

If network access fails, report the updater error and suggest running the installer manually from a freshly downloaded repository. Do not delete local skills after a failed download or failed package validation.

Comments

Markdown supported