design-tweak

Propose minimal surface tweaks to reduce residual design-heuristic severities.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/speplinski/hackathon-opus-47 --skill design-tweak
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-tweak
Source: https://github.com/speplinski/hackathon-opus-47/tree/main/skills/design-tweak
Command: npx skills add https://github.com/speplinski/hackathon-opus-47 --skill design-tweak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iterative refinement for L8's multi-round loop that targets residual design-heuristic severities by proposing minimally invasive tweaks to the current surface, preserving all already-resolved aspects.

Core Features & Use Cases

  • Proposes targeted, minimal surface tweaks that address specific non-zero heuristics without regressing zeros.
  • Integrates with the L8 design-tweak and design-optimize cycle, enabling rapid re-audits of a single surface.
  • Use Case: After a re-audit returns residuals on h2 and h5, propose a minimal wording and layout adjustment to reduce both severities while keeping h1 stable.

Quick Start

Provide the cluster context and audit inputs to generate a precise tweak; the output should be a self-contained new_snapshot ready for re-audit.

Frequently Asked Questions about design-tweak

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

FAQPage Schema
How do I reduce residual design-heuristic severities during iterative refinement?▼

To reduce residual design-heuristic severities, apply surgical surface tweaks that target specific non-zero heuristics while preserving already resolved aspects, generating a new snapshot for re-audit.

What is the best way to make minimal surface adjustments without regressing resolved design heuristics?▼

The best way to avoid regressing resolved design heuristics is to propose targeted tweaks that explicitly preserve zero-severity heuristics while addressing only the residual non-zero severities in the current surface.

How do I prepare cluster context and audit inputs for multi-round design refinement?▼

Preparing for multi-round design refinement requires providing the current cluster context and audit trace inputs, which generate a precise tweak output as a self-contained new snapshot ready for re-audit.

Can I re-audit a single surface after applying a targeted design tweak?▼

Yes, you can re-audit a single surface by loading the newly generated snapshot back into the design-optimize loop, enabling rapid re-evaluation of the updated heuristic severities.

When should I use surgical design tweaks in the L8 multi-round loop?▼

Use surgical design tweaks when a cluster has residual non-zero heuristics after a re-audit, guiding you to make minimal wording and layout adjustments to reduce severities without destabilizing the surface.