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.