Skip to content
Skills Library
Documents & office · Writing

google-developer-docs

/google-developer-docs

Draft, rewrite, or audit developer documentation using an independently expressed interpretation of the Google developer documentation style. Use for API guides, tutorials, concepts, setup instructions, code explanations, command-line documentation, and technical content for a global developer audience.

Licence
MIT
Last repository change
19.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Draft, rewrite, or audit developer documentation using an independently expressed interpretation of the Google developer documentation style. Use for API guides, tutorials, concepts, setup instructions, code explanations, command-line documentation, and technical content for a global developer audience.

Original author description

Draft, rewrite, or audit developer documentation using an independently expressed interpretation of the Google developer documentation style. Use for API guides, tutorials, concepts, setup instructions, code explanations, command-line documentation, and technical content for a global developer audience.

How it works

  1. Protect the source material
  2. Plan the page
  3. Write the prose
  4. Write procedures
  5. Format for scanning
  6. Avoid
  7. Final pass
Original SKILL.md headings · 74 lines, 537 words
SKILL.md preview
---
name: google-developer-docs
description: Draft, rewrite, or audit developer documentation using an independently expressed interpretation of the Google developer documentation style. Use for API guides, tutorials, concepts, setup instructions, code explanations, command-line documentation, and technical content for a global developer audience.
---

# Google developer docs

Produce developer documentation that helps a reader understand or complete a
technical task without decoding the prose.

## Protect the source material

- Preserve facts, code, commands, names, URLs, prerequisites, and constraints.
- Do not invent product behavior, defaults, compatibility, or results.
- Mark a missing fact as a question or placeholder instead of guessing.
- Follow a project-specific terminology or API guide before this style.

## Plan the page

1. Identify the reader, their assumed knowledge, and the outcome they need.
2. Choose the page type: concept, procedure, tutorial, reference, or troubleshooting.
3. Put prerequisites before the first action that depends on them.
4. Lead with the outcome and the shortest useful context. Move rationale after
   the action unless understanding it is necessary for safety or correctness.
5. Decide one term for each concept and use it throughout.

## Write the prose

- Address the reader as `you` when describing their actions.
- Give every important action a visible actor and verb.
- Prefer active voice when the actor matters. Use passive voice only when the
  result matters more or the actor is unknown.
- Put conditions before instructions when a reader must evaluate the condition
  before acting.
- Keep one main idea in each sentence and one purpose in each paragraph.
- Define an unfamiliar term on first use. Expand an uncommon abbreviation once.
- Use literal, globally understandable language. Remove idioms, wordplay, and
  culture-specific comparisons from instructional content.
- Use present tense for current behavior. Attach time-sensitive claims to a
  version or date.
- State limitations directly. Do not soften them with promotional language.

## Write procedures

- Start each step with an imperative verb.
- Keep one primary action per numbered step. Put the expected result after it.
- Tell the reader where to act before naming a UI control if context is unclear.
- Provide copyable commands and code. Explain placeholders next to the example.
- Add a verification step when success is not visible.
- Add cleanup or rollback when the procedure creates persistent resources.

## Format for scanning

- Use sentence case for headings and front-load the distinguishing words.
- Use numbered lists for sequences and bullets for unordered choices.
- Use backticks for code, commands, filenames, literal values, and text to enter.
- Use bold for visible interface labels when the output format supports it.
- Use descriptive link text that states the destination or purpose.
- Introduce a table or list so the reader knows how to use it.

## Avoid

- `simply`, `easily`, `obviously`, and similar judgments about difficulty
- vague pronouns whose referent could be a service, file, command, or result
- `allows you to` when a direct action states the same fact
- unnecessary `please`, filler introductions, and recap paragraphs
- unexplained metaphors, jokes in errors, and human traits assigned to software
- swapping synonyms for variety when they name one technical concept

## Final pass

Confirm that the reader can identify the outcome, prerequisites, first action,
success signal, and next step. Then remove words that do not change meaning,
resolve ambiguous references, and test that examples still match the prose.

Read [references/provenance.md](references/provenance.md) only for source,
attribution, licensing, or maintenance questions.
Files in this package (3)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/provenance.md 1 KB

Versions

The database has no other skills named google-developer-docs.

Database snapshot: 13.11.2026 · package version cf1cf5fc2614 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100google-dev-docs
    Use when writing API documentation, READMEs, tutorials, reference guides, error messages, or any technical content for developers using the Google developer documentation style guide.
  • 100google-devdocs-style
    Write and review developer documentation in Google Developer Documentation Style. Use when drafting guides, API reference, READMEs, procedures, or release notes, not UI strings, commit messages, PR bodies, or code comments.
  • 100kubernetes-docs
    Draft, rewrite, or audit Kubernetes and cloud-native documentation using an independently expressed interpretation of Kubernetes documentation style. Use for concepts, tasks, tutorials, references, configuration, operations, and version-sensitive guidance involving clusters,…
  • 100technical-documentation
    Audit, write, and improve developer documentation using Google''s Developer Documentation Style Guide and Technical Writing courses. Use this skill for any documentation work, even when the user names no style guide: "audit our docs", "review this README", "write a README",…
  • 100tech-writer-researcher
    Write and research technical documentation. Cover information architecture, style guides, API documentation, user research, content strategy, and documentation operations. Triggers on "write technical documentation", "create API docs", "developer tutorial", "information…
  • 100make-docs
    Create, edit, and validate technical documentation using the Diataxis framework. Use when writing tutorials, how-to guides, reference docs, or explanations. Use when reviewing or auditing existing documentation for structural correctness. Use when deciding what type of document…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.