CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

os-scripting

Operating system and shell scripting troubleshooting workflow for Linux, macOS, and Windows. Covers bash scripting, system administration, debugging, and automation.

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/os-scripting/SKILL.md

The canonical home for this skill is os-scripting in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable workflow bundle whose main weakness is token efficiency: the majority of commands, the boilerplate script template, and the troubleshooting catalogs restate knowledge Claude already has, all inlined in a single long file. Phases and quality gates give a clear sequence, but per-phase validation loops are implicit rather than explicit.

Suggestions

Cut or move standard-command catalogs (uname/top/ps/ping/dig, ShellCheck install, cron syntax) into a reference file or trim to non-obvious flags and caveats only, keeping SKILL.md as a lean phase overview.

Add explicit validation loops inside phases, e.g. after running ShellCheck: 'if findings remain, fix and re-run before proceeding to Phase 3', and a verify-after-fix step in Phase 6.

Move the full script template and Bats example into references/ files linked one level deep ('Script template: see TEMPLATE.md'), preserving the overview role of SKILL.md.

DimensionReasoningScore

Conciseness

Much of the ~420-line body is standard knowledge Claude already has: diagnostic commands like 'uname -a', 'top', 'ps aux', 'df -h', 'ping host', 'traceroute', 'nslookup'; ShellCheck install instructions; cron schedule syntax; and a full boilerplate bash template with argument parsing, logging helpers, and a usage() heredoc. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than 1, since the material is presented tersely as command lists rather than padded explanatory prose.

2 / 5

Actionability

The body is dominated by concrete, executable material: full copy-paste command blocks per phase ('shellcheck script.sh', 'journalctl -xe', 'strace -p PID'), a complete runnable script template with 'set -euo pipefail' and trap-based error handling, a working Bats test file, and a systemd timer unit. It falls short of anchor 5 due to placeholder targets ('ping host', 'curl -v http://host', 'dig domain'), 'systemctl status service-name', and '# Your code here' in the template — minor gaps that still need the user to fill in specifics.

4 / 5

Workflow Clarity

Seven clearly labeled phases (Environment Assessment → Script Analysis → Debugging → Script Development → Testing → System Troubleshooting → Automation), each with numbered actions, skills to invoke, and a closing 'Quality Gates' checklist that functions as an end-of-workflow validation gate. It misses anchor 5 because validation inside phases is often implicit (e.g., Phase 2 says 'Run ShellCheck' but doesn't say what to do on failures, and Phase 6's 'Implement fixes' has no verify-after-fix loop). The skill is diagnostic rather than destructive/batch, so the validation cap at 3 does not apply.

4 / 5

Progressive Disclosure

Section structure is clear and consistent (Overview, When to Use, phases, scenarios, gates), but the file is monolithic: the full production script template, the Bats test example, and the multi-category troubleshooting command catalogs (~420 lines total, no references/, scripts/, or assets/ directories exist) are inlined in SKILL.md where a reference-file split would keep the overview lean. This matches anchor 3 ('some structure but could be better organized; content that should be separate is inline') — not 2, because section headers and navigation are present.

3 / 5

Total

13

/

20

Passed

Description

57%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A serviceable description with a clear 'what' and good domain keywords, but it reads as a topical summary rather than an action-oriented trigger description. The missing 'Use when...' clause is the largest structural gap, and the coverage terms are category-level rather than concrete actions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when debugging shell script errors, writing production bash scripts, or troubleshooting Linux/macOS/Windows system issues.'

Replace generic category words ('automation', 'system administration') with concrete actions like 'write cron/systemd timers', 'lint scripts with ShellCheck', 'diagnose CPU, memory, disk, and network issues'.

Include natural synonyms users would type — 'shell script', '.sh', 'bash', 'cron', 'server troubleshooting' — to strengthen trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain clearly ('Operating system and shell scripting troubleshooting workflow for Linux, macOS, and Windows') and lists several areas — 'bash scripting, system administration, debugging, and automation' — but these are topical categories rather than concrete, verifiable actions like 'extract text' or 'fill forms'. It sits between anchor 3 (1-2 concrete actions) and anchor 4 (several specific actions); the generic 'Covers ... automation' phrasing keeps it below 4.

3 / 5

Completeness

It clearly answers 'what' (OS/shell scripting troubleshooting workflow covering bash, sysadmin, debugging, automation) but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description. Per the rubric, a missing explicit 'when' clause caps completeness at 3; it is not lower because the 'what' is clear and reasonably detailed.

3 / 5

Trigger Term Quality

Strong natural keywords users would actually say: 'shell scripting', 'bash scripting', 'troubleshooting', 'debugging', 'system administration', plus the three OS names. It falls short of anchor 5 because it misses common variations and synonyms such as '.sh', 'shell script', 'cron', 'systemd', or 'server' phrasing.

4 / 5

Distinctiveness Conflict Risk

Naming the three operating systems and bash anchoring gives it some distinct identity, but 'system administration', 'debugging', and 'automation' are extremely broad terms that overlap with many other skills (devops, debugging, CI/CD, server management). It fits anchor 3: 'somewhat specific but could still overlap with similar skills'.

3 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/os-scripting/SKILL.md

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.