comet-tweak

Executes lightweight OpenSpec changes through a streamlined four-phase Comet preset workflow.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/JhonMA82/api-starter --skill comet-tweak-jhonma82
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: comet-tweak
Source: https://github.com/JhonMA82/api-starter/tree/main/.opencode/skills/comet-tweak
Command: npx skills add https://github.com/JhonMA82/api-starter --skill comet-tweak-jhonma82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying small or medium changes (config tweaks, documentation updates, delta-spec adjustments) through a full design-and-plan workflow adds unnecessary overhead. This Skill provides a lightweight preset path that chains OpenSpec's open, apply, verify, and archive phases without requiring a full design document. ## Core Features & Use Cases - Streamlined OpenSpec Flow: Creates proposal, design, tasks, and optional delta spec artifacts, then applies tasks directly via the OpenSpec apply action. - State-Managed Phases: Uses Comet CLI state commands (init, select, guard, transition) to track open → build → verify → archive progression with branch/worktree isolation options. - Upgrade Assessment: Detects qualitative-change signals (new capabilities, schema changes, cross-module coordination) and pauses for the user to decide between continuing the tweak or escalating to the full comet-classic workflow. - Use Case: A developer needs to adjust a configuration value and update the corresponding spec scenario. They invoke the tweak preset, which creates a single OpenSpec change, applies the tasks, runs lightweight verification, and archives the change after confirmation. ## Quick Start Invoke the tweak preset by asking the assistant to handle a small configuration or spec change as a single OpenSpec change using the comet-tweak workflow.

Frequently Asked Questions about comet-tweak

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

FAQPage Schema
How do I apply a small change with OpenSpec without a full design doc?▼

Use the tweak preset workflow, which creates streamlined proposal, design, and tasks artifacts, then runs the OpenSpec apply action directly. It skips Superpowers brainstorming and full planning while still verifying and archiving the change.

When should I use comet-tweak instead of comet-classic?▼

Use tweak when the change fits a single OpenSpec change, needs no design doc or full plan, and involves no cross-module architecture coordination. Choose comet-classic for new capabilities, schema changes, public APIs, or deep architecture work.

Can a tweak change include a delta spec?▼

Yes, delta spec is a first-class artifact in tweak using only MODIFIED or ADDED requirement sections. Creating a delta spec alone does not trigger an upgrade, but it routes verification to full OpenSpec-native verification mode.

What happens if a tweak change grows too large?▼

The workflow pauses at qualitative-change signals or when changed files exceed the hint threshold, and the user decides whether to continue or upgrade. Upgrading runs a state transition that converts the workflow to full and rolls back to the design phase.

Does comet-tweak run automatically without user input?▼

It executes continuously through all phases by default, pausing only for genuine decisions like upgrade assessment, verification deviations, and final archive confirmation. Setting auto_transition to false makes it stop at each phase boundary.