| SpellGrammarSuggestionsList | |
|---|---|
 | |
| Description | AI-powered script to suggest spelling and grammar corrections for a list of articles |
| Author | Phlsph7 |
| First released | December 28, 2025 (2025-12-28) |
| Updated | January 1, 2026 (5 months ago) |
| Browsers | all modern browsers |
| Skins | Vector (2022), Vector legacy (2010), MinervaNeue |
| Source | User:Phlsph7/SpellGrammarSuggestionsList.js |
SpellGrammarSuggestionsList is a user script to detect spelling and grammar errors. It processes a list of articles and suggests improvements, which can be reviewed and further adjusted before making any changes to an article. The script uses an AI model to generate suggestions and an API key from OpenAI is required. The script has various limitations and may produce inaccurate suggestions.
Installation and usage
To install this script, go to your common.js and add the following line:
importScript('User:Phlsph7/SpellGrammarSuggestionsList.js'); // Backlink: [[User:Phlsph7/SpellGrammarSuggestionsList.js]]
To start the script, click on the link "SpellGrammarSuggestionsList" in the toolbox ("Tools", on the top right of the screen in the Vector 2022 skin).
An API key from OpenAI is required to use the script. To obtain an API key, first create an OpenAI account.
- Go to https://platform.openai.com/signup and follow the process. It is free but a phone number is required for verification.
- Once you have an account, you can generate an API key. To do so, go to https://platform.openai.com/account/api-keys and click on "Create new secret key".
- The API key starts with "sk-....". Copy it.
- Go back to Wikipedia, open the user script, click on the button "Add/Remove API key", and paste it. The script saves the API key locally on your device and does not share it with Wikipedia or anyone else. The usage of the API key is free during the trial period, but payments to OpenAI are required afterwards.
After adding the API key, you can obtain correction suggestions by entering a list of articles you wish to review and clicking on the button "Start". For example, if you want to review Stubs, you could go to Category:All stub articles, copy several article titles, and paste them into the script. Alternatively, you can click the button "Add 10 random articles", which automatically selects ten random articles. The script can also be used on user pages and info pages.
After pressing the button "Start", the script will produce improvement suggestions for each article. This can take several seconds depending on the length of the article. When completed, a blue button will appear for each article. Clicking it opens the improvement suggestions in a new tab to review and adjust.
If you run into problems or have suggestions on how to improve the script, please discuss them at User_talk:Phlsph7/SpellGrammarSuggestionsList.
Limitations
The suggestions are created by an AI model and can contain inaccuracies. For example, the script may misidentify correct expressions as mistakes or overlook actual errors. In some cases, it may confuse text in templates, such as infoboxes or citation templates, with article prose and attempt to modify it. For these reasons, the script should not be used to make changes blindly. A thorough human review is always required.
The script can only deal with short and medium-sized articles. To get improvement suggestions for long articles, you can try the script User:Phlsph7/SpellGrammarSuggestions.
Screenshots
