golemandClaude Opus 5.5
3413e20601
AMO has formatted descriptions as Markdown since March 2025 and shows any HTML as plain text, so the pasted HTML version showed its tags on the live listing. The README's description is now Markdown, with gpt and the template example as inline code. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.7 KiB
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.
-
Correction from the draft. The description does not say ChatGPT opens "in a new tab":
gptsearches 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 byoptions/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.