CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

report-to-google-doc

Narrow conversion skill. Invoke only when the user explicitly asks to convert an existing local or blob-hosted HTML analytics report into a Google Doc, DOCX, or shareable document.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

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

A highly actionable, well-sequenced skill body with explicit validation gates, an error-recovery repairs table, and appropriate delegation of implementation detail to the bundled helper. Its only weaknesses are mild verbosity in the Standards section and inline density that could be offloaded to a reference file.

DimensionReasoningScore

Conciseness

The body is dense and task-specific with no explanation of concepts Claude already knows — every Standards and Repairs line is a real conversion constraint. It matches 'efficient; minor instances of over-explanation that could be trimmed' (the long Standards list and handoff step could be slightly tightened). It is not 5 because the Standards section in particular carries some lines that could be condensed.

4 / 5

Actionability

Guidance is fully executable: the exact bash invocation with paths and flags, a complete JSON upload call including MIME type, concrete validation predicates ('status: "passed"' with zero errors), and runnable local checks (py_compile, jq, test). It matches 'copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The six-step sequence has an explicit upload gate ('Do not upload until preflight_checks.json has status: "passed" with zero errors'), a dedicated validation step comparing uploaded content against the manifest, and a Repairs table that serves as a validate -> fix -> retry feedback loop — matching the top anchor with explicit validation steps and error-recovery loops. It is not 4 because checkpoints are explicit rather than implied.

5 / 5

Progressive Disclosure

Implementation detail correctly lives in the real scripts/ bundle (report_to_google_doc_plan.py and the report_to_google_doc package both exist), and SKILL.md stays at workflow altitude with well-organized Workflow / Standards / Repairs / Local Checks sections and one-level-deep referenced paths. It matches 'good structure; most content appropriately placed; minor organization gaps' — the dense Standards and Repairs sections could arguably move to a reference file, keeping it below 5.

4 / 5

Total

18

/

20

Passed

Description

82%Weight 40%Scale 1-5

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

A tight, well-scoped description that explicitly answers both what the skill does and when to invoke it, with strong distinctiveness. The main improvement opportunity is broadening natural trigger terms and enumerating a slightly richer action set.

Suggestions

Add common synonyms and extensions users may say, such as 'Word document', 'Google Drive', or '.docx'.

Mention one or two more concrete actions (e.g., render charts as inline images, upload to Drive and validate) to lift specificity beyond a single convert verb.

Optionally name the HTML -> DOCX -> Drive upload pipeline in the description so the output path is discoverable at trigger time.

DimensionReasoningScore

Specificity

The description names the domain ('HTML analytics report') and a concrete action ('convert ... into a Google Doc, DOCX, or shareable document') with specific input sources ('local or blob-hosted'), but the action list is a single verb rather than several concrete actions, so it matches 'domain and 1-2 concrete actions, but not comprehensive'. It does not reach 4 because it does not enumerate multiple distinct operations (e.g., render, preserve formatting, upload).

3 / 5

Completeness

Both what ('convert an existing local or blob-hosted HTML analytics report into a Google Doc, DOCX, or shareable document') and when ('Invoke only when the user explicitly asks to convert...') are explicitly stated with concrete trigger phrases, matching the top anchor. It is not 4 because the 'when' clause is fully explicit rather than weakly specified.

5 / 5

Trigger Term Quality

Natural user phrasings are well covered — 'convert', 'HTML analytics report', 'Google Doc', 'DOCX', 'shareable document' — matching 'good keyword coverage; a few natural terms missing'. It falls short of 5 because common synonyms and extensions such as 'Word document', 'Google Drive', or '.docx' are absent.

4 / 5

Distinctiveness Conflict Risk

'Narrow conversion skill' plus the tight scoping to HTML analytics reports and explicit-only invocation gives a clear niche with distinct triggers and minimal conflict risk, matching the top anchor. Nothing in the wording would fire for unrelated document skills.

5 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/data-analytics/skills/build-report/report-to-google-doc/SKILL.md

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.