netlify-cli-and-deploy
Guide for using the Netlify CLI and deploying sites. Use when installing the CLI, linking sites, deploying (Git-based or manual), managing environment variables, or running local development. Covers netlify dev, netlify deploy, Git vs non-Git workflows, and environment variable management.
93
89%
Does it follow best practices?
Impact
100%
1.12xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly identifies its domain (Netlify CLI), lists specific actions and commands, and provides explicit 'Use when' triggers. It uses proper third-person voice and covers both the 'what' and 'when' comprehensively with natural trigger terms that users would actually use.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: installing the CLI, linking sites, deploying (Git-based or manual), managing environment variables, running local development. Also names specific commands like 'netlify dev' and 'netlify deploy'. | 3 / 3 |
Completeness | Clearly answers both what ('Guide for using the Netlify CLI and deploying sites') and when ('Use when installing the CLI, linking sites, deploying, managing environment variables, or running local development'). The 'Use when' clause is explicit with multiple trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Netlify CLI', 'deploying sites', 'netlify dev', 'netlify deploy', 'environment variables', 'local development', 'Git-based', 'manual deploy'. These cover common variations of how users would phrase Netlify-related requests. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche around Netlify CLI specifically. The mention of specific Netlify commands (netlify dev, netlify deploy) and Netlify-specific workflows makes it very unlikely to conflict with other deployment or CLI skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured reference skill that provides highly actionable CLI commands and configuration examples with excellent conciseness. Its main weaknesses are the lack of validation/verification steps in deployment workflows (e.g., checking deploy status after deploying) and the monolithic structure that could benefit from splitting detailed sections into separate reference files.
Suggestions
Add validation checkpoints to the deployment workflow, such as verifying deploy status with 'netlify deploy --json' output or checking the deploy URL after deploying.
Consider splitting the environment variables section and command reference table into separate bundle files, with brief summaries and links in the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient throughout. It doesn't explain what Netlify is, what CLI tools are, or other concepts Claude already knows. Every section delivers concrete commands and configuration without padding. | 3 / 3 |
Actionability | Nearly every section provides copy-paste ready commands and code snippets. The environment variable management section is particularly thorough with concrete examples for set, get, list, import, delete, and context scoping. The Vite plugin configuration is fully executable. | 3 / 3 |
Workflow Clarity | The deployment workflows (Git-based vs manual) are clearly distinguished, and the linking flow starts with a check ('Check if already linked with netlify status'). However, there are no explicit validation checkpoints or error recovery steps — e.g., no guidance on verifying a deploy succeeded, checking deploy logs, or handling failed builds. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and a useful reference table, but it's a fairly long single file with no bundle files to offload detailed content to. The one cross-reference ('See the netlify-frameworks skill') is good, but the environment variables section and command reference table could potentially be split out for better progressive disclosure. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- netlify/context-and-tools
- Commit
cffaf74
- 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.