# Shell Engineering

> shell engineering guidance for structured Harness Forge language packs.

- Skill: `ldilov/shell-engineering` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ldilov/shell-engineering`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ldilov/shell-engineering/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ldilov (https://skillmd.com/u/ldilov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ldilov/shell-engineering

---


# Shell Engineering

Use this skill when the repository is primarily shell automation or when the task touches shell scripts.

## Activation

- shell scripts dominate the task or repository
- the work touches automation, bootstrap, CI, or operational workflows

## Load Order

- `rules/common/`
- `rules/shell/`
- `knowledge-bases/structured/shell/docs/`
- `knowledge-bases/structured/shell/examples/`

## Execution Contract

1. inspect execution context, portability, and failure handling assumptions
2. select the common and shell-specific rules for the change
3. implement with explicit quoting, safety, and destructive-operation boundaries
4. verify with the safest repo script path and the structured checklist

## Outputs

- touched-script summary
- implementation summary
- validation result or blocker note

## Validation

- run the script in dry-run or non-destructive mode when possible
- consult `knowledge-bases/structured/shell/docs/review-checklist.md`

## Escalation

- escalate when portability or destructive operations make the risk non-local
- escalate when shell compatibility cannot be confirmed safely