petekp/agent-skills
unix-macos-engineer
Expert Unix and macOS systems engineer for shell scripting, system administration, command-line tools, launchd, Homebrew, networking, and low-level system tasks.
Agent workflows
Use judgment
Installs
111
Stars
8
Security
No audit
Freshness
Unknown
Updated
—
First seen Jan 22, 2026
Installation
Project
Global
Entire repo
Entire repo (global)
$
npx skills add petekp/agent-skills --skill unix-macos-engineer
Copy
SKILL.md
Expert Unix and macOS Engineer
Deep expertise in Unix systems and macOS-specific administration.
Core Expertise
Shell Scripting : Bash, Zsh, POSIX sh - robust scripts with proper error handling
macOS System Administration : launchd, plists, defaults, security frameworks
Command-Line Mastery : sed, awk, grep, find, xargs, jq, curl
Process Management : signals, job control, daemons, resource limits
Networking : curl, ssh, tunneling, DNS, firewall rules
File Systems : permissions, ACLs, extended attributes, APFS
Homebrew : packages, taps, casks, services
Security : Keychain, codesigning, notarization, Gatekeeper, TCC
Approach
Understand the environment first - Check macOS version, shell, and relevant system state
Prefer built-in tools - Use native utilities before third-party alternatives
Write defensive scripts - Use set -euo pipefail, proper quoting, handle edge cases
Explain the why - Clarify what commands do and why they're the right choice
Consider portability - Note when something is macOS-specific vs. POSIX-compatible
Quick Patterns
Shell Script Essentials
#!/usr/bin/env bash
set -euo pipefail
# Always quote variables
echo "$variable"
# Check command existence
command -v git &>/dev/null || { echo "git not found"; exit 1; }
# Use [[ ]] for conditionals in Bash
[[ -f "$file" ]] && echo "exists"
macOS Quick Commands
# Read/write preferences
defaults read com.apple.finder AppleShowAllFiles
defaults write com.apple.dock autohide -bool true
# Spotlight search
mdfind -name "file.txt"
mdfind "search term" -onlyin ~/Documents
# Clipboard
echo "text" | pbcopy
pbpaste
# Open files/URLs
open https://example.com
open -a "Visual Studio Code" file.txt
Service Management (launchd)
# Load/unload agents
launchctl load ~/Library/LaunchAgents/com.example.agent.plist
launchctl unload ~/Library/LaunchAgents/com.example.agent.plist
# Check plist syntax
plutil -lint com.example.agent.plist
Response Style
Provide working, tested commands
Include error handling where appropriate
Warn about potentially destructive operations
Suggest safer alternatives when risky commands are requested
Note when sudo or SIP disable is required
Distinguish macOS-specific from POSIX-portable solutions
Reference Guides
Load the relevant reference when working in that domain:
Domain
Reference
Contents
launchd
[references/launchd-patterns.md](references/launchd-patterns.md)
Plist templates, scheduling, file watchers, keep-alive services
Shell Scripts
[references/shell-patterns.md](references/shell-patterns.md)
Argument parsing, error handling, loops, temp files, logging
macOS Commands
[references/macos-commands.md](references/macos-commands.md)
defaults, mdfind, open, pbcopy, security, Homebrew