release-smoke-test

Validates packed oh-my-opencode-slim release candidates against OpenCode runtime before npm publish.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/MDSIXONE/opencode-config --skill release-smoke-test-mdsixone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-smoke-test
Source: https://github.com/MDSIXONE/opencode-config/tree/main/skills/release-smoke-test
Command: npx skills add https://github.com/MDSIXONE/opencode-config --skill release-smoke-test-mdsixone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing a plugin release without testing the actual packed artifact risks shipping crashes or regressions that only appear in the installed tarball, not in the source tree. This Skill provides a repeatable workflow to smoke-test an oh-my-opencode-slim release candidate in an isolated OpenCode environment before public npm publish. ## Core Features & Use Cases - Isolated artifact testing: Builds, packs, and installs the tarball into a throwaway app so validation never depends on the local package cache or source tree. - Environment sanitization: Uses env -i with a temporary HOME and XDG_CONFIG_HOME to strip host variables that could silently add plugins or provider aliases, plus opencode debug config verification of plugin origins. - Crash regression detection: Runs opencode run --print-logs --log-level DEBUG and searches logs for known crash signatures such as the OpenCode 1.17.11 malformed-message TypeError. - Use Case: Before publishing a bugfix release, pack the candidate, install it in a temp directory, run an isolated smoke prompt, confirm no crash signatures appear in logs, and record the results on the release issue using the provided reporting template. ## Quick Start Ask the AI to smoke-test the current oh-my-opencode-slim release candidate by packing it, installing the tarball in an isolated environment, and running an OpenCode smoke prompt.

Frequently Asked Questions about release-smoke-test

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

FAQPage Schema
How do I smoke-test an npm package before publishing?▼

Build the package, run npm pack into a temp directory, install the tarball into a throwaway app, and execute it against the target runtime. Testing the packed artifact catches issues that the source tree and @latest installs miss.

How to test an OpenCode plugin in an isolated environment?▼

Create a temporary HOME and XDG_CONFIG_HOME with a minimal opencode.json pointing at the installed plugin's dist/index.js, then run with env -i to strip host variables. Verify with opencode debug config that plugin_origins contains only the intended plugin.

Why should I test the packed tarball instead of the source tree?▼

The packed tarball is what users actually install from npm, and packaging issues like missing dist files or wrong entry points only appear in the artifact. Testing the source tree can pass while the published package is broken.

What if the isolated environment cannot resolve provider aliases?▼

Run a second host-provider smoke using OPENCODE_CONFIG_DIR while keeping the plugin path pointed at the tarball install. Label it as weaker isolation and use opencode debug config to disclose what other config merged in.

How do I check for crash regressions in OpenCode logs?▼

Run opencode with --print-logs --log-level DEBUG, then search the log directory with ripgrep for signatures like TypeError, undefined property access, or the specific malformed-message pattern. No matches should appear for a passing smoke test.