# Troubleshoot and Automate Operating Systems

Shell troubleshooting often becomes inconsistent across diagnosis, repair, testing, and automation. This skill provides a structured workflow for Bash analysis, Linux diagnostics, testing, and scheduled operations.

## Install

```bash
npx skillstore add sickn33/os-scripting
```

## Metadata

- Status: approved
- Slug: sickn33-os-scripting
- Skillstore revision: r2
- Version status: missing
- Tree hash: febcba5c670241d3bb93868ffd8ac9a47441a972260505c8737f4941fc0bf6a9
- Author: sickn33
- GitHub username: sickn33
- License: MIT
- Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/os-scripting
- Ref: 81e05e636292629114b76cbb3922fbe57672fc02
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/sickn33-os-scripting
- Manifest: https://skillstore.pages.dev/api/skills/sickn33-os-scripting/manifest

## Capabilities

- Guides environment assessment with system, process, resource, and network diagnostics.
- Reviews Bash scripts for syntax, quoting, error handling, and variable usage.
- Provides a defensive Bash structure with logging, option parsing, and strict modes.
- Outlines Bats tests for successful execution, failures, arguments, and generated files.
- Organizes incident diagnosis, service checks, cron scheduling, and systemd timer planning.

## Use Cases

- Repair a failing shell script: Trace errors, apply defensive Bash patterns, and define focused regression tests.
- Diagnose a Linux service incident: Collect system evidence, rank likely causes, and prepare controlled recovery steps.
- Plan recurring maintenance: Design a tested script, scheduling approach, monitoring checks, and rollback procedure.

## Prompt Templates

### Assess a system issue

```
Assess this system issue: [SYMPTOMS]. Identify the operating system, collect read-only diagnostics, explain findings, and request approval before any change.
```

### Review a Bash script

```
Review [SCRIPT] for quoting, error handling, portability, and unsafe assumptions. Explain each issue, propose revisions, and outline ShellCheck validation.
```

### Design shell tests

```
Design Bats tests for [SCRIPT] covering success, missing arguments, edge cases, and failures. Describe fixtures, isolation, expected results, and cleanup.
```

### Investigate and automate recovery

```
Investigate [INCIDENT] on [ENVIRONMENT]. Build a phased diagnostic plan, rank hypotheses, minimize privilege, define rollback steps, and propose monitored automation.
```

## Limitations

- Most executable examples target Linux and Unix shells, despite the broader cross-platform description.
- The skill does not inspect a live system unless the agent receives permission to run commands.
- Several workflow steps reference related skills that may not be installed.
- Privileged changes, service restarts, and scheduled jobs require environment-specific approval and validation.

## Best Practices

- Begin with read-only diagnostics and record the current state before making changes.
- Validate scripts with ShellCheck and focused tests before deployment or scheduling.
- Request explicit approval for privileged commands, service changes, and persistent automation.

## Anti Patterns

- Do not run broad root-level searches before confirming scope and resource impact.
- Do not restart services or edit schedules without validation and rollback steps.
- Do not paste untrusted values into shell commands without quoting and input validation.

## Security Audit

- Audited at: 2026-08-04T16:56:32.309\+00:00
- Summary: All 88 static findings are false positives caused by Markdown formatting or transparent operating system administration examples. No prompt injection, hidden execution, credential access, data exfiltration, or malicious persistence intent was found.

## Stats

- Views: 93
- Downloads: 14
- Favorites: 0
- Popularity score: 0