search-with-chatgpt-powered-by-openai-extension/docs/superpowers/specs/2026-10-18-amo-listing-design.md

Add-ons listing for 1.3

Status: implemented on docs/24-amo-listing-add-screenshots-and-a (#24). The paste-ready text and captions are in docs/amo/, along with the page that renders the images.

Problem

The AMO listing had no screenshots, and its description covered only the gpt keyword. It never mentioned right-click, the keyboard shortcut, or the toolbar button. The listing is where newcomers decide to install and first learn how to use the extension.

Decisions

• Tone: clear, with one joke. The copy gives plain steps for newcomers. A general cat joke ("gpt why does my cat knock things over?") replaces the old programmer joke ("sudo make me a sammich"), and the images share the cat theme.

• Say it is small. Customization without bloat is what sets this extension apart, so the description has a "Small on purpose" section: about 56 KB, no libraries, no server, no API key, no intermediary, and nothing reported to us. These are the README's privacy claims; nothing new is claimed.

• Drawings as screenshots. The images are the options page's drawings, enlarged and rendered by headless Firefox:

  • They are part of the extension's own UI.
  • They stay sharp and on brand.
  • They can be regenerated after UI changes.

  Real screenshots would show OS-specific menus and go stale. A real screenshot of the options page is suggested as a sixth image, taken by the maintainer, because one genuine screenshot builds trust in the rest.

• AMO's guidance. Images are 1280×800, the size AMO recommends and its largest display size, and carry no added text. Explanations go in each image's caption.

• The copy rule holds. ChatGPT opens with the text filled in; it is never sent, searched, or asked. Temporary chat and web search are described as hints, and "private", "incognito", and "secure" appear nowhere near temporary chat.

• Branding stays. The name's "powered by OpenAI" and the extension's own icon follow OpenAI's brand guidelines: no OpenAI logo on unofficial software, and only the phrases the guidelines allow. The description's "unofficial" line complements them.

• Correction from the draft. The description does not say ChatGPT opens "in a new tab": gpt searches open in the current tab, and the other ways follow the Open ChatGPT in setting.

Files

• docs/amo/README.md: summary, description (Markdown, which AMO has used instead of HTML since March 2025), captions in upload order, and how to regenerate the images.
• docs/amo/screenshots.html: the drawing markup at 1280×800, one image per #fragment, styled by options/options.css.
• docs/amo/screenshots/*.png: the five rendered images. They are generated and git-ignored rather than committed, so the repository carries no binaries and needs no Git LFS. The command to produce them is in the README.

docs/ is excluded from the extension package, so none of this ships to users.