CtrlK
BlogDocsLog inGet started
Tessl Logo

google-style-guide

Use when writing or reviewing technical documentation to follow Google's documentation style guide. Triggers on tasks involving technical writing, doc review, style consistency, inclusive language, or formatting standards.

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Critical

Do not install without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/google-style-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a reasonable overview of Google's documentation style guide principles with decent structure and references to deeper content. Its main weaknesses are limited actionability (few concrete before/after examples) and the lack of a clear review workflow. The content is moderately concise but could be tightened by removing the HTML comment block and some generic statements.

Suggestions

Add 3-4 concrete before/after examples showing incorrect vs correct writing (e.g., passive→active voice, poor→good headings, non-inclusive→inclusive language) to improve actionability.

Add a brief review workflow/checklist: e.g., '1. Check voice/tense 2. Check headings for sentence case 3. Check inclusive language 4. Verify code formatting' to improve workflow clarity.

Remove the HTML comment block at the end—it wastes tokens and contains meta-instructions not relevant to Claude's use of the skill.

Provide the referenced bundle files (language-grammar.md, formatting.md, inclusive-language.md) or note their absence, as the progressive disclosure structure depends on them existing.

DimensionReasoningScore

Conciseness

Mostly efficient but includes some unnecessary explanation. Phrases like 'Write for software developers and technical practitioners' and 'Prioritize user understanding over strict grammatical rules' are somewhat generic. The HTML comment block at the end adds unnecessary tokens. However, the core content is reasonably lean.

2 / 3

Actionability

Provides concrete guidelines and one example (active voice/present tense), but lacks executable code examples or copy-paste ready templates. For a style guide skill, more before/after examples of correct vs incorrect writing would significantly improve actionability. The guidance is more descriptive than instructive.

2 / 3

Workflow Clarity

For a style guide skill, there's no clear workflow for how to apply the guide during a review process (e.g., checklist order, what to check first, how to validate compliance). The content reads as a reference card rather than a process. Since this is an instruction-only skill, a simple 'when reviewing docs, check these in order' workflow would help.

2 / 3

Progressive Disclosure

References to three detailed files in references/ are well-signaled and one level deep, which is good. However, since no bundle files were provided, we cannot verify these references exist. The main file itself is well-structured with clear sections, but the HTML comment block clutters the end and should not be in the skill content.

2 / 3

Total

8

/

12

Passed

Description

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid description that clearly communicates when to use the skill and anchors itself to a specific style guide (Google's), which provides strong distinctiveness. Its main weakness is that the capabilities described are somewhat high-level — it would benefit from listing more concrete actions the skill performs rather than broad categories like 'style consistency' and 'formatting standards.'

Suggestions

Add specific concrete actions the skill performs, e.g., 'Enforces active voice, corrects heading hierarchy, flags non-inclusive terminology, applies consistent list formatting, and checks link text quality.'

DimensionReasoningScore

Specificity

The description names the domain (technical documentation) and references Google's style guide, but the actions are vague — 'writing or reviewing' and 'style consistency, inclusive language, formatting standards' are broad categories rather than concrete actions like 'enforce active voice, correct heading capitalization, flag biased terminology.'

2 / 3

Completeness

The description explicitly answers both 'what' (follow Google's documentation style guide for technical documentation) and 'when' ('Use when writing or reviewing technical documentation' plus explicit trigger list). The 'Triggers on...' clause serves as a clear 'Use when' equivalent.

3 / 3

Trigger Term Quality

Good coverage of natural trigger terms: 'technical documentation', 'technical writing', 'doc review', 'style consistency', 'inclusive language', 'formatting standards', and 'Google's documentation style guide' are all terms users would naturally use when seeking this kind of help.

3 / 3

Distinctiveness Conflict Risk

The specific reference to Google's documentation style guide creates a clear niche. While 'technical writing' could overlap with general writing skills, the explicit mention of Google's style guide and specific concerns like inclusive language and formatting standards make this distinctly identifiable.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
mcclowes/skills-docusaurus
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.