comet-tweak

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

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill comet-tweak-shrek-abaper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: comet-tweak
Source: https://github.com/shrek-abaper/sap-nexus-agent/tree/main/.comet/skills/skills/comet-tweak
Command: npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill comet-tweak-shrek-abaper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying small or medium changes (config tweaks, documentation updates, prompt optimizations, delta-spec adjustments) with the full heavyweight design workflow wastes effort, while skipping structure entirely loses traceability. This Skill provides a streamlined preset path that keeps OpenSpec change governance without the full design-doc overhead. ## Core Features & Use Cases - Streamlined OpenSpec Change Flow: Chains open, apply, verify, and archive phases with tweak defaults, skipping Superpowers brainstorming and full planning. - Delta Spec as First-Class Artifact: Supports ## MODIFIED Requirements and ## ADDED Requirements delta specs as normal artifacts without forcing an upgrade to the full workflow. - Upgrade Assessment with User Decision Points: Detects qualitative-change signals (cross-module coordination, new public API, schema changes) and file-count tripwires, then pauses for the user to choose between continuing tweak or escalating to the full classic workflow. - Use Case: A developer needs to adjust a configuration value and update the corresponding spec acceptance scenario. They invoke the tweak preset, which creates a streamlined proposal, tasks list, and delta spec, applies the change through OpenSpec, runs scale-appropriate verification, and archives the change after confirmation. ## Quick Start Invoke the tweak preset by typing /comet-tweak followed by a description of the lightweight change you want to make.

Frequently Asked Questions about comet-tweak

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

FAQPage Schema
How do I run a lightweight OpenSpec change without the full design workflow?▼

Invoke the tweak preset, which chains open, apply, verify, and archive phases with streamlined defaults. It skips Superpowers brainstorming and full planning while still producing a proposal, brief design, tasks list, and optional delta spec.

When should I use tweak instead of the full classic workflow?▼

Use tweak when the change fits a single OpenSpec change, needs no design doc or full plan, and involves no cross-module or cross-layer architecture coordination. Qualitative signals like new public APIs or schema changes should escalate to the full workflow.

Does creating a delta spec force an upgrade to the full workflow?▼

No. Delta spec is a first-class normal artifact in tweak, using only MODIFIED or ADDED Requirements sections. Needing a delta spec alone never triggers an upgrade; it only routes verification to full OpenSpec-native mode.

What happens when the file-count tripwire is hit during a tweak?▼

When changed files exceed the hint threshold, the workflow pauses and asks the user whether to continue tweak or upgrade to full. The agent never upgrades or continues on its own; file count is only a prompt, not an automatic escalation.

Can the tweak workflow run automatically without user interaction?▼

Yes, it runs as one-time continuous execution through all phases. It only pauses for genuine user decisions: upgrade assessment signals, verification deviation acceptance, and final archive confirmation.