recipe-deploy-apps-script
Push local files to a Google Apps Script project.
72
60%
Does it follow best practices?
Impact
100%
10.00xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/recipe-deploy-apps-script/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 is minimal and functional but lacks the completeness needed for reliable skill selection. It identifies the core action and target platform but omits trigger guidance and natural user keywords. Without a 'Use when...' clause, Claude may struggle to select this skill appropriately from a large skill library.
Suggestions
Add a 'Use when...' clause with trigger terms like 'deploy to Apps Script', 'push to GAS', 'upload script files', 'clasp push'
Include common variations and file types: 'GAS', '.gs files', 'script project', 'Apps Script deployment'
Expand specific actions: 'Push local JavaScript/TypeScript files to a Google Apps Script project, sync changes, deploy script updates'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Google Apps Script) and one action (push local files), but lacks comprehensive coverage of what 'push' entails or additional capabilities. | 2 / 3 |
Completeness | Describes what it does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'Google Apps Script' and 'push' which are relevant, but misses common variations like 'GAS', 'clasp', 'deploy', 'upload script', or 'sync files'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Google Apps Script project' provides some specificity, but 'push local files' is generic enough to potentially conflict with other deployment or file sync skills. | 2 / 3 |
Total | 7 / 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.
This is a well-crafted, concise skill that provides actionable CLI commands for deploying Apps Script projects. The main weakness is the lack of validation steps between updating content and creating a version - there's no guidance on verifying the update succeeded or handling potential errors in the deployment workflow.
Suggestions
Add a validation step after updateContent to verify the push succeeded (e.g., re-fetch content and compare, or check for error responses)
Include brief error handling guidance for common failure scenarios (e.g., permission denied, invalid script ID)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing only the essential commands without explaining what Apps Script is or how the CLI works. Every line serves a purpose. | 3 / 3 |
Actionability | Provides fully executable CLI commands with concrete parameter examples and JSON payloads that are copy-paste ready with minimal modification (just replacing SCRIPT_ID). | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced for the deployment workflow, but lacks validation checkpoints - no verification that updateContent succeeded before creating a version, and no error handling guidance. | 2 / 3 |
Progressive Disclosure | For this simple, single-purpose skill under 50 lines, the structure is appropriate. The prerequisite skill reference is clear and one level deep. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- googleworkspace/cli
- Commit
6ed836c
- 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.