This is a comprehensive shell scripting reference with 49 rules organized by priority, from critical safety issues like command injection prevention down to style preferences. It's built for AI agents but reads like a well-structured style guide. You'd pull this in when writing bash scripts, reviewing Dockerfiles, or debugging CI pipelines. The rules are properly categorized (safety, portability, error handling) and each links to detailed examples with before/after code. Honestly, the strict prioritization is the standout bit here. It separates "your script will have security holes" from "your indentation is inconsistent," which matters when you're trying to ship fast. Based on solid sources like ShellCheck and the Google style guide.

skills.sh installs
704
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill shell --agent claude-code

Installs into .claude/skills of the current project.

Files

Shell Scripts Best Practices (Community)

Comprehensive best practices guide for shell scripting, designed for AI agents and LLMs. Contains 49 rules across 9 categories, prioritized by impact from critical (safety, portability) to incremental (style). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics.

When to Apply

Reference these guidelines when:

  • Writing new bash or POSIX shell scripts
  • Reviewing shell scripts for security vulnerabilities
  • Debugging scripts that fail silently or behave unexpectedly
  • Porting scripts between Linux, macOS, and containers
  • Optimizing shell script performance
  • Setting up CI/CD pipelines with shell scripts

Rule Categories by Priority

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
DevOps & CI/CD, Documentation, Code Review & Quality, Debugging, Automation & Workflows, Sales & Marketing, CLI & Terminal
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1alirezarezvani avataragent-designeralirezarezvani/claude-skillsUse when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate 703skills.sh installs
2mohitmishra786 avatarelf-inspectionmohitmishra786/low-level-dev-skillsELF binary inspection skill for Linux. Use when examining ELF executables or shared libraries with readelf, objdump, nm, or ldd to understand symbol visibility,702skills.sh installs
3ruvnet avatardossier-collectruvnet/rufloBuild a graph-structured dossier on a seed entity via parallel fan-out + recursive expansion across web, memory, knowledge-graph, codebase, ADR index, and git i702skills.sh installs
4joellewis avatarcounterparty-riskjoellewis/finance_skillsGuide counterparty credit risk measurement and management for OTC and securities trading, organized around three workflows: assessing a new counterparty, respon700skills.sh installs
5fluxcd avatargitops-repo-auditfluxcd/agent-skillsAudit and validate Flux CD GitOps repositories by scanning local repo files (not live clusters) — runs Kubernetes schema validation, detects deprecated Flux API699skills.sh installs
6nowledge-co avatarsave-threadnowledge-co/communitySave the real Claude Code or Grok Build session messages only when the user explicitly requests it. Use nmem t save to import the recorded session, not a summar699skills.sh installs