script-writer
Write production-ready one-off scripts and automation utilities with proper error handling and safety patterns. Use when developing bash automation, Python CLI tools, shell scripts, system administration scripts, or command-line batch processing—e.g., "write a script to process files", "python one-liner for data conversion", "bash automation for backups", "shell script with error handling".
86
82%
Does it follow best practices?
Impact
90%
1.20xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
92%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 articulates capabilities and provides explicit trigger guidance with natural user phrases. The description uses proper third-person voice and includes concrete examples. Minor weakness is potential overlap with other Python or system administration skills, though the 'one-off scripts' framing helps differentiate it.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'production-ready one-off scripts', 'automation utilities', 'proper error handling and safety patterns', and specific examples like 'bash automation', 'Python CLI tools', 'shell scripts', 'system administration scripts', 'command-line batch processing'. | 3 / 3 |
Completeness | Clearly answers both what ('Write production-ready one-off scripts and automation utilities with proper error handling') AND when ('Use when developing bash automation, Python CLI tools...') with explicit trigger examples in quotes. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'bash automation', 'Python CLI tools', 'shell scripts', 'process files', 'python one-liner', 'data conversion', 'backups', 'error handling'. These are phrases users naturally use when requesting scripting help. | 3 / 3 |
Distinctiveness Conflict Risk | While it specifies scripting and automation, there's potential overlap with general Python development skills or system administration skills. The focus on 'one-off scripts' helps distinguish it, but 'Python CLI tools' could conflict with broader Python development skills. | 2 / 3 |
Total | 11 / 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 skill demonstrates strong organization and token efficiency with clear progressive disclosure to language-specific references. However, it lacks concrete executable examples in the main file and could benefit from explicit validation workflows for destructive script operations. The principles are well-articulated but remain somewhat abstract without accompanying code snippets.
Suggestions
Add 1-2 minimal executable code examples demonstrating key safety patterns (e.g., a bash strict mode snippet, a Python input validation example)
Include an explicit validation workflow step such as 'Test with --dry-run flag first' or 'Validate on sample data before full execution' to strengthen safety guidance for destructive operations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, avoiding explanations of concepts Claude already knows. Every section serves a purpose with no padding or unnecessary context about what scripts are or how they work. | 3 / 3 |
Actionability | Provides clear principles and requirements but lacks concrete code examples. The guidance is specific ('use env vars', 'return meaningful exit codes') but no executable snippets demonstrate these patterns directly in the main skill file. | 2 / 3 |
Workflow Clarity | The output requirements section provides a 3-step checklist, but lacks explicit validation checkpoints or feedback loops. For a skill involving potentially destructive operations, there's no explicit 'validate before running' or 'test in safe mode first' workflow. | 2 / 3 |
Progressive Disclosure | Excellent structure with a clear overview and well-signaled one-level-deep references to language-specific files. The 'Load on Demand' section clearly indicates when to load each reference file. | 3 / 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
- jjjermiah/dotagents
- Commit
b74de5e
- 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.