ReviseMy Try with your agent

Second opinion

Second opinion hints. Your marks decide.

Every upload gets a free, type-aware checklist. Optional vision models can mark regions on the capture. Suggestions never override human marks or flip the review decision.

The problem

One-shot AI critique often sounds decisive — and agents treat it that way. You need optional design hints that stay labeled as suggestions while humans remain the authority on approve / request-changes.

How ReviseMy fits

  1. 1

    create_review runs the free checklist immediately.

  2. 2

    With an Anthropic or OpenAI key, vision can add dashed region hints.

  3. 3

    add_findings lets agents push suggestions before you open the link.

  4. 4

    get_review returns pins first; second_opinion stays hints.

How second opinion works

Free checklist on every upload

Type-aware heuristics for UI, website, email, and slides — hierarchy, contrast, CTAs, density, and more. No API key required.

Optional vision regions

With ANTHROPIC_API_KEY or OPENAI_API_KEY (or an OpenAI-compatible base URL), vision findings can carry an area and render as dashed markers on the screenshot.

Human marks stay authoritative

Solid rose marks are yours. Second opinion never auto-flips status. Overlaps enrich under related_pin — they do not invent a conflicting must-fix.

Agent subagent path

Agents can call add_findings before you open the link. Those land with an Agent badge as suggestions — still not decisions.

How it stays non-contradictory

  • Human marks = intent (must-fix, nit, question, keep, …) exposed as work_packets.pins
  • Findings = suggestions only (suggestion / a11y / polish)
  • Checklist findings have no area; only vision findings may point at a region
  • request_second_opinion re-runs checklist (+ vision when keyed)
  • Open the craft chip on a review to see which public lenses apply for that type

Where the craft lenses come from

Type-aware second opinion draws on published craft principles. Findings are ReviseMy hints — not quotes, reviews, or endorsements from the people or organizations behind these works.

UI craft

2 lenses

  • IIDS

    shiftnudge.com/iids

    Typography hierarchy, grids and alignment, proportion, precision, and restraint — International Interface Design Style.

  • Laws of UX

    lawsofux.com

    Psychology heuristics visible in a still — aesthetic-usability, simplicity (Prägnanz), similarity, choice density, and target size.

Website craft

2 lenses

  • IIDS

    shiftnudge.com/iids

    Typography hierarchy, grids and alignment, proportion, precision, and restraint — International Interface Design Style.

  • A List Apart

    alistapart.com

    Web-native craft for a still — content hierarchy, responsive layout clarity, web typography, and progressive enhancement.

Slide craft

2 lenses

  • Presentation Zen

    garrreynolds.com/design-tips

    Design for the back of the room, use emptiness as design, and strip non-essentials.

  • Slide craft

    Duarte: slide design

    One idea per slide, glance-media clarity (~3 seconds), and contrast that amplifies the point instead of camouflaging it.

Email craft

1 lens

  • Good Email Code

    goodemailcode.com

    Live text over image-baked copy, accessibility first, progressive enhancement, and client-resilient layout.

ReviseMy-distilled heuristics for this review type — not affiliated with, endorsed by, or quoting these people or organizations on your review. On a review, open the craft chip next to Second opinion for the lenses that apply to that type.

FAQ

Do I need an API key for second opinion?

Not for the free checklist — it runs on every upload. Vision region hints need your own Anthropic or OpenAI key on the server (BYOK). Optional REVISEMY_VISION_PROVIDER and OpenAI-compatible base URLs for Ollama and similar.

Can second opinion approve a review?

No. Only you approve or request changes. Agents follow next_action from your decision and must treat second_opinion as hints.

How do I refresh hints?

Use Refresh second opinion on the review page, or have the agent call request_second_opinion.

Are these designers reviewing my UI?

No. ReviseMy distills public craft principles into checklist and vision hints. The craft chip and this page name the sources; nobody outside your loop is reviewing or endorsing your screenshots.

Try with your agent