opt-shell-install

Install or upgrade @reopt-ai/opt-shell with npm registry and peer dependency checks.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/reopt-ai/reopt-skills --skill opt-shell-install
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opt-shell-install
Source: https://github.com/reopt-ai/reopt-skills/tree/main/skills/opt-shell-install
Command: npx skills add https://github.com/reopt-ai/reopt-skills --skill opt-shell-install

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps consumer projects install or upgrade @reopt-ai/opt-shell without breaking app shell conventions, legacy package references, or required peer dependencies.

Core Features & Use Cases

  • Fresh installs and upgrades: Handles both initial setup and version updates for projects using the opt-shell runtime layer.
  • Legacy migration: Detects and guides migration from the older @reopt-ai/opt-harness package name to @reopt-ai/opt-shell.
  • Workspace integration: Routes users to the correct shell documentation for workspace recipes, policy configuration, adapters, and safe app-shell wiring.
  • Safety checks: Verifies public npm registry settings, peer dependencies, and breaking-change requirements before making changes.

Quick Start

Ask the assistant to install or upgrade opt-shell in the current project and verify the shell configuration, peers, and registry settings.

Frequently Asked Questions about opt-shell-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely upgrade opt-shell in an existing React workspace?

To safely upgrade opt-shell in a React workspace, the process verifies public npm registry settings, checks peer dependencies, and routes you to shell documentation for workspace recipes and policy configuration before applying version updates.

How do I migrate from the legacy @reopt-ai/opt-harness package to opt-shell?

Migrating from the legacy @reopt-ai/opt-harness package to opt-shell involves detecting old package references and applying legacy migration rules to safely transition your project to the new app-shell runtime layer.

Do I need to verify peer dependencies before installing opt-shell?

Yes, verifying peer dependencies is required before installing opt-shell to ensure product-frame behavior, policy configuration, and data-engine adapters function correctly without breaking existing app shell conventions in your consumer project.

What npm registry settings are required to install opt-shell?

Installing opt-shell requires public npm registry validation to preserve package registry integrity, ensuring your consumer project can correctly access the app-shell runtime layer and associated workspace recipes.

Why does my opt-shell installation fail during workspace recipe wiring?

opt-shell installation may fail during workspace recipe wiring if public npm registry validation is blocked, peer dependencies are missing, or legacy @reopt-ai/opt-harness migration rules are not properly resolved before setup.