CtrlK
BlogDocsLog inGet started
Tessl Logo

recipe-generate-report-from-sheet

Read data from a Google Sheet and create a formatted Google Docs report.

61

Quality

52%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/recipe-generate-report-from-sheet/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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

The description identifies a clear workflow (Sheets to Docs report) but is too brief and lacks explicit trigger guidance. It would benefit from listing specific capabilities (e.g., chart insertion, table formatting) and adding a 'Use when...' clause with natural trigger terms to help Claude distinguish this skill from other Google Workspace or reporting skills.

Suggestions

Add a 'Use when...' clause with trigger terms like 'generate report from spreadsheet', 'Google Sheets to Docs', 'create document from sheet data'.

List more specific actions such as 'formats tables, inserts charts, summarizes spreadsheet data into structured sections'.

Include common keyword variations like 'spreadsheet', 'gsheet', 'report generation', '.gsheet' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (Google Sheets, Google Docs) and describes two actions (read data, create report), but lacks detail on what 'formatted' means or what kinds of reports are generated.

2 / 3

Completeness

Describes what the skill does but has no 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also only moderately detailed, warranting a 1.

1 / 3

Trigger Term Quality

Includes 'Google Sheet' and 'Google Docs report' which are natural terms, but misses common variations like 'spreadsheet', 'gsheet', 'document', or terms like 'generate report from spreadsheet data'.

2 / 3

Distinctiveness Conflict Risk

The combination of Google Sheets input and Google Docs output is somewhat distinctive, but 'read data' and 'create report' are generic enough to overlap with other reporting or Google Workspace skills.

2 / 3

Total

7

/

12

Passed

Implementation

72%

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

This is a concise, well-structured recipe skill that clearly sequences the steps for reading sheet data and creating a report. Its main weaknesses are the lack of validation checkpoints between steps and the disconnect between the data read in step 1 and the hardcoded report content in step 3, which makes the data transformation aspect unclear.

Suggestions

Show how to capture the document ID from the create response and use it in subsequent steps (e.g., 'Save the returned documentId for use in the next step').

Add a brief note or step showing how to transform the sheet data from step 1 into the report text in step 3, rather than using entirely hardcoded content.

Add validation checkpoints: verify the sheet read returned data before creating the doc, and confirm doc creation succeeded before writing to it.

DimensionReasoningScore

Conciseness

The skill is lean and efficient. It assumes Claude knows what Google Sheets and Docs are, provides no unnecessary explanation, and every line serves a purpose.

3 / 3

Actionability

The commands are concrete and copy-paste ready, but the example uses hardcoded placeholder data (DOC_ID, SHEET_ID) without showing how to capture and pass the document ID from step 2 into step 3. The report content is also hardcoded rather than showing how to transform the sheet data into the report text.

2 / 3

Workflow Clarity

Steps are clearly sequenced, but there are no validation checkpoints—no verification that the sheet read returned data, no check that the document was created successfully before writing, and no confirmation that sharing succeeded. For a multi-step workflow involving external API calls, this is a gap.

2 / 3

Progressive Disclosure

For a short, single-purpose recipe skill, the structure is appropriate. The prerequisite skills are clearly signaled at the top, and the content is well-organized without needing external references.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
googleworkspace/cli
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.