research-skills-installer

research-skills-installer is a lightweight CLI for installing and upgrading Research Skills assets in your project for Codex, Claude Code, and Gemini workflows.

What it does

Install workflow/skill assets into your project
Upgrade assets to newer upstream versions
Support codex, claude, gemini, or all targets
Run doctor checks before/after installation

Installation

pip install research-skills-installer

Or with pipx:

pipx install research-skills-installer

CLI

Main command and aliases:

research-skills
rsk
rsw

Check updates

rsk check

Upgrade assets

rsk upgrade --project-dir /path/to/project --target all --doctor

The package includes a default upstream repo (jxpeng98/research-skills), so --repo is optional. Use --repo only when you want to override the default.

Override default repo (optional)

The CLI resolves upstream repo in this order:

--repo argument
RESEARCH_SKILLS_REPO environment variable
research-skills.toml or .research-skills.toml in your project path
Packaged default (research_skills/project.toml)

Option A: Global override

Add this to your shell profile (~/.zshrc, ~/.bashrc, etc.):

export RESEARCH_SKILLS_REPO="<owner>/<repo>"

Then reload shell:

source ~/.zshrc

Now you can run:

rsk check
rsk upgrade --project-dir /path/to/project --target all --doctor

Option B: Project-level override

Create research-skills.toml in your project root:

[upstream]
repo = "jxpeng98/research-skills"
url = "https://github.com/<owner>/<repo>"

This keeps the override local to that project.

Typical usage

# Install from PyPI
pipx install research-skills-installer

# Upgrade assets into your project
rsk upgrade --project-dir /path/to/project --target all --doctor

Metadata

Release files for research-skills-installer 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for research-skills-installer 0.4.0
File	Size	Uploaded
research_skills_installer-0.4.0.tar.gz	60.3 kB	Apr 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for research-skills-installer 0.4.0
File	Interpreter	ABI	Platform	Reset
research_skills_installer-0.4.0-py3-none-any.whl 26.0 kB Apr 1, 2026	Python 3	none	any	Details

Total release size: 86.3 kB

Release files / research_skills_installer-0.4.0.tar.gz

Download URL	research_skills_installer-0.4.0.tar.gz
Size	60.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`d7f24748cd6f67962cefe5c483f12363ed13c49d9a029eab10d89b3f623d9212`
BLAKE2b-256 checksum How to use checksums	`d776cd1f4a7eeed258a72d9a761c992dfdff8c5dee1e3cc1fe455356e0e68b93`
Upload date	Apr 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/jxpeng98/research-skills
Publishing commit: github.com/jxpeng98/research-skills/tree/cf497a2bda39b24bc51df6084187f454fa2955e8

Workflow

Publishing configuration: github.com/jxpeng98/research-skills/blob/cf497a2bda39b24bc51df6084187f454fa2955e8/.github/workflows/publish-pypi.yml
Publishing logs: github.com/jxpeng98/research-skills/actions/runs/23864787280/attempts/1

Artifact

Subject: research_skills_installer-0.4.0.tar.gz
SHA-256 checksum: d7f24748cd6f67962cefe5c483f12363ed13c49d9a029eab10d89b3f623d9212 Verifying attestations

Release files / research_skills_installer-0.4.0-py3-none-any.whl

Download URL	research_skills_installer-0.4.0-py3-none-any.whl
Size	26.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a1bb8badd9c1cbfb3ff0a2aa11c2e3a461e88626eba2c8c4173c905ab6d388cd`
BLAKE2b-256 checksum How to use checksums	`64f2daf89d553e9e5995ae7327369e446518591ddcc0a1b2fcb9cf7c6996d5ff`
Upload date	Apr 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/jxpeng98/research-skills
Publishing commit: github.com/jxpeng98/research-skills/tree/cf497a2bda39b24bc51df6084187f454fa2955e8

Workflow

Publishing configuration: github.com/jxpeng98/research-skills/blob/cf497a2bda39b24bc51df6084187f454fa2955e8/.github/workflows/publish-pypi.yml
Publishing logs: github.com/jxpeng98/research-skills/actions/runs/23864787280/attempts/1

Artifact

Subject: research_skills_installer-0.4.0-py3-none-any.whl
SHA-256 checksum: a1bb8badd9c1cbfb3ff0a2aa11c2e3a461e88626eba2c8c4173c905ab6d388cd Verifying attestations