Read data from a Google Sheet and create a formatted Google Docs report.
61
52%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/recipe-generate-report-from-sheet/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
c7c6646
Table of Contents
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.