opencode-bootstrap-json

Generates opencode-bootstrap-json metadata blocks for scaffold, verification, and runtime smoke commands.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jason23452/my-skill --skill opencode-bootstrap-json-jason23452
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-bootstrap-json
Source: https://github.com/jason23452/my-skill/tree/main/env/opencode-bootstrap-json
Command: npx skills add https://github.com/jason23452/my-skill --skill opencode-bootstrap-json-jason23452

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Defining consistent bootstrap metadata for OpenCode skills is error-prone: scaffold commands, verification commands, runtime smoke checks, and dependency fields often drift across framework, UI kit, API client, and testing skills. This Skill provides a single specification for producing clean, executable, boundary-scoped opencode-bootstrap-json fenced blocks. ## Core Features & Use Cases - Metadata Field Specification: Defines role, category, frameworks, requiresPrimarySkills, order, packageManager, scaffoldCommand, verificationCommands, runtimeSmokeCommand, and runtimeSmokeHealthUrl with clear boundary rules per skill type. - Script Launcher Pattern: Standardizes short launcher commands that delegate multi-step file generation to bundled .cjs scripts with preseeded-directory fallbacks. - Boundary Enforcement: Separates framework scaffold, UI kit, API client, testing, Docker, and docs-only README add-ons so each skill only expresses its own business scope. - Use Case: When authoring a new Nuxt UI kit add-on skill, use this Skill to emit a compliant metadata block with empty-mutation verification launchers and correct requiresPrimarySkills wiring. ## Quick Start Ask the assistant to generate an opencode-bootstrap-json metadata block for a new testing add-on skill following the boundary rules.

Frequently Asked Questions about opencode-bootstrap-json

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

FAQPage Schema
How do I write opencode-bootstrap-json metadata for a new skill?▼

Define role, category, frameworks, order, packageManager, scaffoldCommand, and verificationCommands according to the skill's boundary. Framework skills keep executable scaffold commands and project-wide build verification, while add-ons declare dependencies via requiresPrimarySkills or requiresUiKitSkills.

What is the difference between framework and add-on skill metadata?▼

Framework metadata owns scaffold commands and expensive project-wide verification like pnpm build. Add-on metadata only checks its own integration state, such as dependency wiring, test discovery, or config presence, and declares its framework dependencies explicitly.

Can a docs-only skill have an empty scaffoldCommand?▼

Yes. Docs-only README rule skills use empty scaffoldCommand and verificationCommands arrays. Selectable docs-only add-ons keep scaffoldCommand empty but must provide a non-mutating bundled verification launcher so find-skills can list them without side effects.

Why use .cjs script launchers in scaffoldCommand?▼

Bundled .cjs scripts remain stable under a target project's type: module setting and carry multi-step file generation logic. The launcher checks the local .opencode/skills path first, then falls back to the preseeded skills directory.

How does runtime smoke verification work in this metadata?▼

runtimeSmokeCommand starts the dev server on $PORT and runtimeSmokeHealthUrl probes readiness. A single connection-refused response only means the server is not ready yet, not a final failure.