ost-phuryn-pm-skills-install

name	ost-phuryn-pm-skills-install
description	Install and update PM Skills Marketplace for Claude Code, Codex CLI, Claude Cowork, or skills-only clients. Primary path: run the support-package install script. Fallback: follow repo_readme_summary.md Part 2. Scope includes setup, update, copy-mode install, and verification; excludes slash-command conversion and workflow tutorials.
argument-hint	--client=codex|claude-code|cowork|gemini|opencode|cursor|kiro [--plugins=all|pm-toolkit,pm-execution] [--location=local|global] [--repo-dir=PATH] [--verify-only]

PM Skills Marketplace Install

Reference: repo_readme_summary.md
Script: scripts_for_install/install.sh
Official repository: phuryn/pm-skills

When to Use

Use this skill when the user wants to install, update, copy, or verify PM Skills Marketplace from phuryn/pm-skills for:

• Claude Code plugin usage.
• Codex CLI plugin usage.
• Claude Cowork GUI usage.
• Skills-only clients: Gemini CLI, OpenCode, Cursor, or Kiro.

The PM Skills Marketplace contains nine plugins. Claude Code and Claude Cowork can use Claude slash commands and skills. Codex CLI installs the same plugin files and can use the skills, but Claude slash commands do not become Codex slash commands. Skills-only clients receive copied skill folders only.

Pre-read

1. ../../repo_readme_summary.md - install and update behavior.
2. ../../scripts_for_install/install.sh - supported clients, flags, platform limits, and verification.

Pre-checks

Confirm the target from context. Use the defaults only when the user has not specified a preference.

Information	Default	Notes
Client	codex	Supported values: codex, claude-code, cowork, gemini, opencode, cursor, kiro.
Plugins	all	Or a comma-separated subset from the nine PM plugins.
Skills-only location	local	Applies only to gemini, opencode, cursor, and kiro.
Existing repo checkout	none	Optional --repo-dir=PATH; without it the script clones phuryn/pm-skills for copy clients.
Verification only	no	Use --verify-only when the user only wants to inspect current state.

Before running any command that modifies local CLI, plugin, or assistant configuration, show the exact command and get user confirmation. This includes plugin marketplace add/update/install commands and skills-only copy commands that write into project or user skills directories.

Procedure

Primary Path: Run the Install Script

Use this path on macOS, Linux, and WSL. From the support-package root, which is two directories above this SKILL.md, run:

sh scripts_for_install/install.sh [flags]

Common examples:

sh scripts_for_install/install.sh --client=codex
sh scripts_for_install/install.sh --client=claude-code --plugins=pm-toolkit,pm-execution
sh scripts_for_install/install.sh --client=cowork
sh scripts_for_install/install.sh --client=opencode --location=local --repo-dir=/path/to/pm-skills
sh scripts_for_install/install.sh --client=gemini --location=global --repo-dir=/path/to/pm-skills
sh scripts_for_install/install.sh --client=codex --verify-only

Supported script flags:

Flag	Purpose
--client=codex	Install or verify through Codex CLI plugin commands.
--client=claude-code	Install or update through Claude Code plugin commands.
--client=cowork	Print Claude Cowork GUI install steps.
--client=gemini	Copy skills to Gemini CLI skills directory.
--client=opencode	Copy skills to OpenCode skills directory.
--client=cursor	Copy skills to Cursor skills directory.
--client=kiro	Copy skills to Kiro skills directory.
--plugins=all	Install or copy all nine PM plugins.
--plugins=a,b,c	Install or copy selected PM plugin names.
--location=local	Project-level skills directory for skills-only clients.
--location=global	User-level skills directory for skills-only clients.
--repo-dir=PATH	Use an existing phuryn/pm-skills checkout for skills-only copy mode.
--verify-only	Skip install/copy and run verification checks only.

The valid plugin names are:

pm-toolkit
pm-product-strategy
pm-product-discovery
pm-market-research
pm-data-analytics
pm-marketing-growth
pm-go-to-market
pm-execution
pm-ai-shipping

For Claude Code, the script adds or refreshes the pm-skills marketplace, installs missing plugins, and updates existing plugins when detected. For Codex CLI, the script adds or upgrades the marketplace snapshot and installs missing plugins. For skills-only clients, the script copies skill folders into the selected local or global target directory.

Fallback Path: Use repo_readme_summary.md

Switch to the fallback path when:

• The platform is native Windows outside WSL.
• The script fails because required commands such as claude, codex, or git are unavailable.
• The user wants manual control over each command.
• Claude Cowork must be installed through the GUI.
• A skills-only client needs a target directory or copy behavior not covered by the script.

Follow ../../repo_readme_summary.md Part 2, "Installation and update", step by step. Present each command that writes local CLI or assistant configuration and wait for user confirmation before running it.

Verification

Use the script verification mode when possible:

sh scripts_for_install/install.sh --client=codex --verify-only
sh scripts_for_install/install.sh --client=claude-code --verify-only
sh scripts_for_install/install.sh --client=opencode --location=local --verify-only

Manual verification commands from the summary:

claude plugin list
claude plugin list --json --available
codex plugin list
codex plugin list --marketplace pm-skills
codex plugin list --available --json

For skills-only clients, verify that the target skills directory contains one or more copied SKILL.md files.

After Installation

Tell the user:

PM Skills Marketplace is installed or copied for the selected client. In Claude Code or Claude Cowork, use the installed PM slash commands and skills. In Codex, invoke the workflows by natural language because Claude slash commands are installed as files but are not Codex slash commands. In Gemini, OpenCode, Cursor, or Kiro, only copied skills are expected to work.

Troubleshooting

Symptom	Cause	Handling
unsupported platform	The script supports macOS, Linux, and WSL only.	Use the fallback path in repo_readme_summary.md Part 2, or use Claude Cowork GUI setup on Windows.
required command not found: claude	Claude Code CLI is not installed or not on PATH.	Install or expose Claude Code CLI before rerunning --client=claude-code, or use another supported client.
required command not found: codex	Codex CLI is not installed or not on PATH.	Install or expose Codex CLI before rerunning --client=codex, or use another supported client.
required command not found: git	Skills-only copy mode needs git when --repo-dir is not supplied.	Provide --repo-dir=/path/to/pm-skills or install git.
Plugin commands installed but unavailable in Codex	Claude slash commands do not run as Codex slash commands.	Use natural language to invoke equivalent PM workflows, or ask separately to convert command files into Codex skills.
No skills found for skills-only client	The selected target directory does not contain copied SKILL.md files.	Rerun the script with the intended --client, --location, and optional --repo-dir; then verify again.