porada/domfiles / .agents/skills/shell-integration
shell-integration
VerifiedUse this skill whenever the resolved task scope includes shell code—including `domlib`, Fish configuration, `home/.local/bin` scripts, and `.hooks`—or adds or reconsiders a command entrypoint in this repository, including whether a Git helper should be a plain alias or a `home/.local/bin/git-*` script. Do not use it merely because the task runs terminal commands.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| references/command-form-and-location.md | markdown | 1.9 KB |
| references/domlib-integration.md | markdown | 3.2 KB |
| references/shared-helper-design.md | markdown | 5.3 KB |
| references/validate-shell-changes.md | markdown | 2.4 KB |
references/validate-shell-changes.md
View on GitHub# Validate Shell Changes
After editing, use the narrowest applicable validation scope:
1. Pass changed paths explicitly to the matching lint wrapper. Omit paths only when repository-wide validation is intended. Explicit paths bypass [default discovery and its pathname limits](../../../PROJECT.md#development-lint-wrapper-architecture). Explicitly pass paths that Git C-quotes. When no paths are supplied, file-oriented wrappers discover tracked files and non-ignored untracked files. The Fish wrapper restricts that inventory to `*.fish` files. The POSIX wrapper uses `*.sh`, `home/.local/bin/*`, and `home/.local/share/*` to include extensionless entrypoints and `domlib`. File-oriented wrappers skip non-files and symlinks.
2. For Fish, run `pnpm run lint:fish <changed-fish-files>`, respecting the [repository scope exclusions](../../../../AGENTS.md#scope). The wrapper already runs `fish --no-execute`, so don’t repeat that check.
3. For POSIX shell, run `sh -n -- <file>` for each changed file and `pnpm run lint:sh <changed-posix-files>`. The wrapper supplies the complementary ShellCheck analysis. For POSIX hooks without hashbangs under `.hooks`, use `env SHELLCHECK_OPTS=--shell=sh pnpm run lint:sh <changed-hook-files>`.
4. For changed `.fish` and `.sh` files and extensionless Fish and POSIX shell scripts with hashbangs, check formatting with `pnpm exec prettier --check <changed-shell-files>`. The configured Fish plugin infers extensionless Fish scripts from their `fish` hashbang, so don’t force `--parser fish`. For POSIX hooks without hashbangs under `.hooks`, run a separate invocation of the formatting command with `--parser sh` and only those hook paths.
5. [Check integration contracts](#check-integration-contracts).
6. Run `git --no-pager diff --check` and, when task-owned changes are staged, `git --no-pager diff --cached --check`. Inspect task-owned untracked files directly without staging them because Git diff doesn’t include them.
## Check Integration Contracts
For affected shell targets, verify:
- Caller migration and contract documentation when command form changes under [Command Form and Location](command-form-and-location.md).
- Caller use of shared defaults and paired-helper alignment under [Shared Helper Design](shared-helper-design.md).
- Entrypoint sourcing, helper placement and ordering, contract comments, repository-wide usage, and required `$DOMFILES_*` counterparts under [`domlib` Integration](domlib-integration.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |