メニュー
Word list from the Google developer documentation style guide. Contains recommended and non-recommended terms with alternatives. The full word list is in word-list.json alongside this file.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | google-developer-style-guide-word-list |
| description | Word list from the Google developer documentation style guide. Contains recommended and non-recommended terms with alternatives. The full word list is in word-list.json alongside this file. |
This skill provides the word list from the Google developer documentation style guide, structured as machine-readable JSON for use in documentation review and authoring.
The file word-list.json (alongside this file) is a JSON array of objects. Each
object has the following fields:
| Field | Type | Description |
|---|---|---|
term | string | The word or phrase. |
recommendation | string | One of "recommended", "not recommended", or "use with care". |
details | string | Explanation and guidance from the style guide. |
use_instead | string or null | The preferred alternative, when the term is not recommended or needs care. |
Look up a specific term:
jq '.[] | select(.term | test("abort"; "i"))' word-list.json
List all terms that are not recommended:
jq '[.[] | select(.recommendation == "not recommended")] | length' word-list.json
Find alternatives for a term:
jq '.[] | select(.term | test("blacklist"; "i")) | {term, use_instead, details}' word-list.json
The word list contains 597 entries across the following recommendation categories:
Accessibility and inclusion rules from the Google developer documentation style guide. Covers accessible documentation, inclusive language, and writing for a global audience.
API reference documentation rules from the Google developer documentation style guide. Covers code comments, class/method documentation, parameter descriptions, and API reference formatting.
Formatting rules from the Google developer documentation style guide. Covers text formatting, code in text, code samples, UI elements, HTML formatting, filenames, placeholders, and command-line syntax.
Grammar rules from the Google developer documentation style guide. Covers articles (a/an/the), pronouns, present tense, contractions, and sentence structure.
Image and media rules from the Google developer documentation style guide. Covers alt text, image quality, screenshots, diagrams, and figure formatting.
Naming and terminology rules from the Google developer documentation style guide. Covers capitalization, abbreviations, spelling, and jargon.