Append a deal status update to a Google Sheets sales tracking spreadsheet.
81
77%
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-log-deal-update/SKILL.mdQuality
Discovery
67%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 is specific and clearly scoped to a narrow task, making it distinctive and unlikely to conflict with other skills. However, it lacks an explicit 'Use when...' clause, which is critical for Claude to know when to select this skill. Adding trigger guidance and a few more natural keyword variations would strengthen it.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to log a deal update, record a sales status change, or append to a sales tracking sheet.'
Include additional natural trigger terms users might say, such as 'CRM update', 'pipeline status', 'deal log', 'sales update', or 'deal progress'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a concrete action ('Append a deal status update') and specifies the target ('Google Sheets sales tracking spreadsheet'). It is specific about what it does, though it describes only a single action rather than multiple. | 3 / 3 |
Completeness | It clearly answers 'what does this do' (appends a deal status update to a Google Sheets sales tracking spreadsheet), but there is no explicit 'Use when...' clause or equivalent trigger guidance, which caps this at 2 per the rubric. | 2 / 3 |
Trigger Term Quality | Includes relevant terms like 'deal status update', 'Google Sheets', 'sales tracking', and 'spreadsheet', which are natural keywords. However, it misses common variations users might say such as 'CRM', 'pipeline', 'deal update', 'sales log', or 'update deal'. | 2 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to a narrow niche — appending deal status updates to a sales tracking spreadsheet in Google Sheets. This is unlikely to conflict with other skills due to its very targeted scope. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, actionable recipe that provides concrete CLI commands for appending a deal update to Google Sheets. Its main weakness is the lack of a verification step after the append operation to confirm success, which would strengthen the workflow for a data-writing task.
Suggestions
Add a verification step after the append (e.g., re-read the last row to confirm it was written correctly)
Consider adding a brief note on error handling if the sheet is not found or the append fails
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Very lean and efficient. No unnecessary explanations of what Google Sheets is or how spreadsheets work. Every line serves a purpose with concrete commands. | 3 / 3 |
Actionability | Provides fully concrete, copy-paste ready CLI commands with specific parameters, query strings, and example data values. The placeholder SHEET_ID is the only abstraction and is clearly implied from step 1's output. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (find → read → append), but there's no validation step to confirm the append succeeded (e.g., re-reading the sheet to verify the row was added) and no error handling guidance. Appending to a shared spreadsheet is a write operation that benefits from verification. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines, the content is well-organized with a clear prerequisite callout and numbered steps. No need for external references given the scope. | 3 / 3 |
Total | 11 / 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 | |
a3768d0
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.