clean-shell SKILL.md skillA

clean-shell from uwuclxdy/agenticat is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add uwuclxdy/agenticat/clean-shell@v1.11

Pins v1.11 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
uwuclxdy/agenticat
Path
skills/clean-shell/SKILL.md
Versions recorded
13
Latest version
v1.11, committed Nov 3, 2026
First version recorded
Jul 19, 2026
Size
4,287 bytes
Repository stars
7
License
MIT

Defensive Bash and POSIX shell rules: strict-mode flags, traps, idempotent mutation, ShellCheck discipline, bats tests.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Clean Shell

Shell-specific conventions for writing, hardening, reviewing, and testing scripts. The core rules below always apply. Load the one reference file matching the task; don't load them all.

| Task touches | File |
|---|---|
| Scripts that run as root or mutate live systems: deploy/apply, firewall/sshd/sudoers edits, systemd oneshot+timer units, ssh remote-exec, rollback, cleanup traps, idempotency, parsing input a foreign process controls (`/proc`, argv, filenames), checking a path stays under a directory | `references/defensive.md` |
| `.shellcheckrc`, `# shellcheck disable=` directives, severity floors, exit codes, CI gating | `references/shellcheck.md` |
| Bats tests: `.bats` files, `run`, `setup`/`teardown`, PATH-stub mocking, parallel jobs | `references/bats.md` |

## Core Rules

- Pick `set` flags by intent and comment the reason next to them: `set -euo pipefail` for orchestration where any failure aborts; drop `-e` when steps may fail without aborting; `set -u` alone for long-running loops. A thin wrapper sets no flags and ends with `exec`.
- Quote every expansion (`"$var"`, `"${arr[@]}"`, `"$(cmd)"`); `--` end-of-options guard before untrusted operands.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add uwuclxdy/agenticat/clean-shell@sha256:c0a0b2d5fe54a90f

The line at the top of this page pins the label v1.11, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j3cisstzuqg7vn4d.svg)](https://markdownregistry.com/a/art_j3cisstzuqg7vn4d)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 13 versions of this file, between Jul 19, 2026 and Nov 3, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
v1.11 latest2026-11-03 c16e3ef 4,287 BA view · diff
v1.102026-10-27 2a83bd9 3,961 BA view · diff
v1.92026-10-26 5f35e84 3,601 BA view · diff
v1.82026-10-26 3f0519a 2,952 BA view · diff
v1.72026-10-25 d272017 2,952 BA view · diff
v1.62026-10-23 2c73ce5 2,952 BA view · diff
v1.52026-10-23 e7aa3be 2,922 BA view · diff
v1.42026-10-09 089861a 2,550 BA view · diff
v1.32026-09-25 472d45f 2,369 BA view · diff
v1.22026-09-06 848740a 2,369 BA view · diff
v1.12026-08-26 bed4238 2,017 BA view · diff
v1.12026-08-02 6ac2614 2,055 BA view · diff
v1.02026-07-19 f2941e8 2,170 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4287 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

uwuclxdy/agenticat · 7 stars · license MIT · pushed 2026-11-06 · branch mommy

API

GET https://markdownregistry.com/api/v1/artifacts/art_j3cisstzuqg7vn4d
GET https://markdownregistry.com/api/v1/resolve?ref=uwuclxdy/agenticat/clean-shell
GET https://markdownregistry.com/api/v1/blob/c0a0b2d5fe54a90f26c74967200cd92c06e4d75dad500d48a0c3650a2d2b7cbf

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from uwuclxdy/agenticat

askama SKILL.md skill
uwuclxdy/agenticat · skills/askama/SKILL.md · Askama Rust templating reference (0.16).
v1.5 · audit A · 7 stars
cargo-toml-optimization SKILL.md skill
uwuclxdy/agenticat · skills/cargo-toml-optimization/SKILL.md · Tunes Rust `Cargo.toml` and `.cargo/config.toml`: profiles, features, workspaces, dependency hygiene.
v1.8 · audit A · 7 stars
clean-code SKILL.md skill
uwuclxdy/agenticat · skills/clean-code/SKILL.md · Language-agnostic clean-code baseline: naming, functions, error handling, comments, duplication.
v1.7 · audit A · 7 stars
clean-flutter SKILL.md skill
uwuclxdy/agenticat · skills/clean-flutter/SKILL.md · Idiomatic Flutter and Dart rules: feature-first layout, Riverpod, freezed, go_router, const correctness.
v1.6 · audit A · 7 stars
clean-rust SKILL.md skill
uwuclxdy/agenticat · skills/clean-rust/SKILL.md · Idiomatic Rust 2024 rules: ownership, error handling, async, unsafe, traits, iterators, clippy.
v1.16 · audit A · 7 stars
docs-sync SKILL.md skill
uwuclxdy/agenticat · skills/docs-sync/SKILL.md · Reconciles README, docs, CLAUDE.md, and agent prompts with what the code does.
v1.14 · audit A · 7 stars
emulator-testing SKILL.md skill
uwuclxdy/agenticat · skills/emulator-testing/SKILL.md · Boots and drives Android AVDs and iOS simulators from the CLI.
v1.9 · audit A · 7 stars
maud SKILL.md skill
uwuclxdy/agenticat · skills/maud/SKILL.md · Maud Rust `html!` macro reference (0.27).
v1.5 · audit B · 7 stars
mcp-stateless SKILL.md skill
uwuclxdy/agenticat · skills/mcp-stateless/SKILL.md · MCP knowledge pack for the stateless 2026-07-28 revision.
v1.0.4 · audit A · 7 stars
name-check SKILL.md skill
uwuclxdy/agenticat · skills/name-check/SKILL.md · Suggests project and crate names and checks availability across crates.io, npm, PyPI, AUR, GitHub, and domains.
v1.6 · audit A · 7 stars
ratatui-patterns SKILL.md skill
uwuclxdy/agenticat · skills/ratatui-patterns/SKILL.md · Modern-ratatui knowledge pack for Rust TUI code on ratatui and crossterm.
v1.7 · audit A · 7 stars
terminal-ux SKILL.md skill
uwuclxdy/agenticat · skills/terminal-ux/SKILL.md · Behavior rules for CLIs and TUIs: exit codes, stdout vs stderr, TTY detection, NO_COLOR, prompts, destructive-action…
v1.5 · audit A · 7 stars

Every file in uwuclxdy/agenticat

Browse by kind, by grade A, or by owner.