@simpleapps-com/augur-skills 2026.3.8 → 2026.3.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bash-simplicity
|
|
3
|
+
description: Bash command conventions — one command per call, use dedicated tools over shell equivalents, check wiki for approved commands. Load this skill before running Bash commands.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Bash Simplicity
|
|
8
|
+
|
|
9
|
+
## One Command Per Call
|
|
10
|
+
|
|
11
|
+
MUST run each Bash command as a separate, simple call. MUST NOT chain commands with `&&`, `||`, pipes, or sub-shells. Complex commands trigger permission prompts and break automation.
|
|
12
|
+
|
|
13
|
+
Wrong: `git -C repo status && pnpm typecheck && pnpm test`
|
|
14
|
+
Right: Three separate Bash calls, one per command.
|
|
15
|
+
|
|
16
|
+
Wrong: `pnpm --filter ampro-online run typecheck 2>&1; echo "EXIT: $?"`
|
|
17
|
+
Right: `pnpm --filter ampro-online run typecheck` — the Bash tool already captures stderr and exit codes. Never add `2>&1`, `; echo $?`, or other shell plumbing — it triggers permission prompts for no benefit.
|
|
18
|
+
|
|
19
|
+
## Use Dedicated Tools
|
|
20
|
+
|
|
21
|
+
Dedicated tools are faster, require no permission, and produce better output. MUST use them instead of Bash equivalents:
|
|
22
|
+
|
|
23
|
+
| Instead of | Use |
|
|
24
|
+
|------------|-----|
|
|
25
|
+
| `grep`, `rg` | Grep tool |
|
|
26
|
+
| `find`, `ls` (for search) | Glob tool |
|
|
27
|
+
| `cat`, `head`, `tail` | Read tool |
|
|
28
|
+
| `sed`, `awk` | Edit tool |
|
|
29
|
+
| `echo >`, `cat <<EOF` | Write tool |
|
|
30
|
+
|
|
31
|
+
Reserve Bash for commands that have no dedicated tool equivalent: build tools, test runners, git, package managers, and system commands.
|
|
32
|
+
|
|
33
|
+
These commands are **denied** in project settings and will always be rejected — do not attempt them:
|
|
34
|
+
`cd`, `cat`, `grep`, `rg`, `find`, `sed`, `awk`, `head`, `tail`, `sleep`, `kill`, `pkill`
|
|
35
|
+
|
|
36
|
+
## Check Before Prompting
|
|
37
|
+
|
|
38
|
+
Before running a command that will trigger a permission prompt, check the wiki and project settings for approved commands. The wiki documents which commands are pre-approved and how to invoke them. Unnecessary permission prompts interrupt the user's flow.
|