design-feedback-to-rule
Skill1 starsChanged 4 months agoMITView on GitHub
Translate subjective design feedback, screenshot annotations, review comments, and stakeholder language into observable design rules, preserved elements, explicit change boundaries, and a validation checklist. Use when feedback says a design feels messy, dense, flat, insufficiently premium, off-brand, or similar; when a user asks to preserve specific states or elements; or when feedback must be clarified before any design or code change. Work read-only and stop before ideation, prototyping, or implementation.
In this repository16 other files it gives its agents.
- analyze-brand-web-experienceSkill
- audit-public-report-languageSkill
- build-before-after-change-deckSkill
- build-design-skill-packageSkill
- build-html-sharing-reportSkill
- content-source-truth-auditorSkill
- context-first-design-executionSkill
- cross-device-recomposition-specSkill
- design-qa-evidence-packSkill
- design-system-contract-lockSkill
- enforce-ui-visual-restraintSkill
- extract-design-systemSkill
- html-to-figma-workflowSkill
- interaction-specimen-builderSkill
- sync-responsive-figma-from-webSkill
- web-design-guidelinesSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Do not edit or create project files, design files, code, copy, tokens, prototypes, or assets.
- Distinctive: line 15
Do not apply the feedback, propose visual directions, or choose an implementation technique.
- Distinctive: line 16
Stop after delivering rules, preserved elements, change boundaries, open decisions, and a validation checklist.
- Distinctive: line 17
Treat a solution named in the feedback as a suggested tactic until the intended outcome is clear.
- Distinctive: line 46
Read feedback-rule-schema.md when the feedback contains vague adjectives, multiple comments, contradictions, or preserved states.
- Distinctive: line 48
Keep the rule at the outcome level.
- Distinctive: line 59
Do not silently expand the scope.
- Distinctive: line 65
Write one rule per concern.
- Distinctive: line 77
Use qualitative checks when the source gives no numeric threshold.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Design Feedback to Rule
Convert one feedback set into an implementation-ready decision contract. Preserve the reviewer's intent without inventing a design solution.
Enforce the boundary
- Work read-only.
- Inspect only the artifacts, screenshots, annotations, files, and states within the user's scope.
- Do not edit or create project files, design files, code, copy, tokens, prototypes, or assets.
- Do not apply the feedback, propose visual directions, or choose an implementation technique.
- Stop after delivering rules, preserved elements, change boundaries, open decisions, and a validation checklist.
- Treat a solution named in the feedback as a suggested tactic until the intended outcome is clear.
- Return a handoff boundary when the same request also asks for implementation.
Read the evidence
- Identify the exact feedback source and preserve its meaning.
- Identify the referenced artifact, component, route, state, viewport, and audience.
- Inspect available source material before interpreting the comment.
- Separate each item into:
- direct observation;
- stated impact or concern;
- desired outcome;
- suggested tactic;
- missing decision.
- Label every inference as an inference. Never present an assumption as reviewer intent.
Normalize the feedback
Rewrite each concern as an outcome that can be observed or tested. Replace adjectives with variables such as:
- information density and scan order;
- hierarchy and emphasis;
- spacing and alignment;
- contrast and legibility;
- image crop and visual continuity;
- motion sequence, duration, and state continuity;
- control affordance and interaction feedback;
- brand token or component compliance.
Read feedback-rule-schema.md when the feedback contains vague adjectives, multiple comments, contradictions, or preserved states.
Keep the rule at the outcome level. Exclude layout inventions, styling prescriptions, component selections, and code instructions unless the reviewer explicitly made them mandatory.
Bound the change
Record four separate sets:
- Preserve: elements, content, states, behaviors, or qualities that must remain.
- Allowed to change: the smallest surface that may change to satisfy the rule.
- Excluded: adjacent surfaces and behaviors that remain outside this feedback.
- Open decisions: ambiguities that can materially change the result.
Do not silently expand the scope. Ask at most one high-leverage question when an unresolved ambiguity changes the rule or boundary. If no answer is available, state the assumption and keep the affected decision open.
Resolve contradictions by preserving both source statements, explaining the conflict, and identifying the decision owner. Do not choose a side without evidence or authority.
Write testable rules
Write one rule per concern. Include:
- rule ID;
- source feedback;
- observed issue and context;
- desired outcome;
- observable rule;
- preserve, allowed, and excluded sets;
- evidence or rationale;
- confidence and open decision;
- validation checks.
Use qualitative checks when the source gives no numeric threshold. Do not invent measurements and present them as requirements. Make every check answerable through inspection, interaction, comparison, or measurement.
Return the contract
Return sections in this order:
- Feedback scope — source, artifact, state, viewport, and assumptions.
- Normalized intent — concise outcome without implementation language.
- Rule table — one row per atomic concern.
- Change boundary — preserve, allowed, excluded, and open decisions.
- Validation checklist — observable checks tied to rule IDs.
- Handoff boundary — state that no design or implementation change was made.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

