agentleFS
Fay1YeeFay1Yee/design-agent-skills/skills/design-feedback-to-rule/SKILL.md

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.

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
  1. Distinctive:

    Do not edit or create project files, design files, code, copy, tokens, prototypes, or assets.

    line 14
  2. Distinctive:

    Do not apply the feedback, propose visual directions, or choose an implementation technique.

    line 15
  3. Distinctive:

    Stop after delivering rules, preserved elements, change boundaries, open decisions, and a validation checklist.

    line 16
  4. Distinctive:

    Treat a solution named in the feedback as a suggested tactic until the intended outcome is clear.

    line 17
  5. Distinctive:

    Read feedback-rule-schema.md when the feedback contains vague adjectives, multiple comments, contradictions, or preserved states.

    line 46
  6. Distinctive:

    Keep the rule at the outcome level.

    line 48
  7. Distinctive:

    Do not silently expand the scope.

    line 59
  8. Distinctive:

    Write one rule per concern.

    line 65
  9. Distinctive:

    Use qualitative checks when the source gives no numeric threshold.

    line 77

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. Identify the exact feedback source and preserve its meaning.
  2. Identify the referenced artifact, component, route, state, viewport, and audience.
  3. Inspect available source material before interpreting the comment.
  4. Separate each item into:
    • direct observation;
    • stated impact or concern;
    • desired outcome;
    • suggested tactic;
    • missing decision.
  5. 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:

  1. Feedback scope — source, artifact, state, viewport, and assumptions.
  2. Normalized intent — concise outcome without implementation language.
  3. Rule table — one row per atomic concern.
  4. Change boundary — preserve, allowed, excluded, and open decisions.
  5. Validation checklist — observable checks tied to rule IDs.
  6. Handoff boundary — state that no design or implementation change was made.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.