@e4779/skills 0.0.0-stage → 0.1.0
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/chrome-devtools/README.md +76 -0
- package/chrome-devtools/SKILL.md +277 -0
- package/chrome-devtools/references/recipes.md +379 -0
- package/chrome-devtools/references/setup.md +138 -0
- package/drawio/SKILL.md +395 -0
- package/gh-cli/SKILL.md +83 -0
- package/grill/SKILL.md +72 -0
- package/layout-check/README.md +32 -0
- package/layout-check/SKILL.md +416 -0
- package/layout-check/scripts/layoutProbe.mjs +539 -0
- package/mcpls/SKILL.md +261 -0
- package/mcpls/references/configuration.md +131 -0
- package/mcpls/references/install.md +13 -0
- package/mcporter/SKILL.md +90 -0
- package/mindmap/SKILL.md +46 -0
- package/mindmap/references/drawio-recipe.md +60 -0
- package/mindmap/references/mindmap-design.md +63 -0
- package/opensource-contribution/SKILL.md +119 -0
- package/package.json +29 -5
- package/shell-taste/.shellcheckrc +16 -0
- package/shell-taste/SKILL.md +95 -0
- package/shell-taste/references/handbook/dialects.md +168 -0
- package/shell-taste/references/handbook/dom/01-output-logging.md +245 -0
- package/shell-taste/references/handbook/dom/02-errors-exit.md +48 -0
- package/shell-taste/references/handbook/dom/03-installation-setup.md +179 -0
- package/shell-taste/references/handbook/dom/04-network.md +384 -0
- package/shell-taste/references/handbook/dom/05-files-paths.md +74 -0
- package/shell-taste/references/handbook/dom/06-checks-validation.md +127 -0
- package/shell-taste/references/handbook/dom/07-system-administration.md +103 -0
- package/shell-taste/references/handbook/dom/08-privilege-users.md +58 -0
- package/shell-taste/references/handbook/dom/09-text-data.md +62 -0
- package/shell-taste/references/handbook/dom/10-terminal-ux.md +60 -0
- package/shell-taste/references/handbook/dom/11-process-control.md +28 -0
- package/shell-taste/references/handbook/dom/12-uncategorized.md +161 -0
- package/shell-taste/references/handbook/dom/13-containers.md +13 -0
- package/shell-taste/references/handbook/dom/14-agents-ai-tooling.md +13 -0
- package/shell-taste/references/handbook/family-index.md +230 -0
- package/shell-taste/references/handbook/index.md +41 -0
- package/skill-author/SKILL.md +86 -0
- package/sobesednik/SKILL.md +98 -0
- package/sobesednik/card-template.md +23 -0
- package/sobesednik/personas/advocate.md +27 -0
- package/sobesednik/personas/analyst.md +29 -0
- package/sobesednik/personas/chat.md +42 -0
- package/sobesednik/personas/ifs.md +32 -0
- package/sobesednik/personas/journal/README.md +6 -0
- package/sobesednik/personas/nasreddin.md +29 -0
- package/sobesednik/personas/premortem.md +29 -0
- package/sobesednik/personas/rogers.md +27 -0
- package/sobesednik/personas/socratic.md +29 -0
- package/sobesednik/personas/stoic.md +27 -0
- package/sobesednik/references/persona-design.md +41 -0
- package/zai-mcp/README.md +63 -0
- package/zai-mcp/SKILL.md +160 -0
- package/zai-mcp/references/recipes.md +273 -0
- package/zai-mcp/references/tools.md +266 -0
- package/README.md +0 -3
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
<!-- GENERATED by shell-atlas bin/handbook (mk handbook). Hand edits WILL be overwritten. as-of: 5539bbbe9ebc 2026-11-08 -->
|
|
2
|
+
|
|
3
|
+
# Output & logging — measured shell idioms
|
|
4
|
+
|
|
5
|
+
37 families (canon ∪ wild join view). as-of 2026-11-08. Index: [index.md](../index.md) · [family-index.md](../family-index.md).
|
|
6
|
+
|
|
7
|
+
### Script Usage Display — These functions provide instructions on how to users can use the shell scripts.
|
|
8
|
+
|
|
9
|
+
wild: 693 units · 220 projects · strata mid
|
|
10
|
+
body: work/wild/units/007revad-synology_enable_m2_volume/0002-usage.sh
|
|
11
|
+
query: jq -r 'select(.family == "007revad-synology_enable_m2_volume/0002-usage") | .name' work/wild/names.jsonl
|
|
12
|
+
|
|
13
|
+
### Logging and Output — These functions provide a formatted output for messages, appending to a file or printing ...
|
|
14
|
+
|
|
15
|
+
wild: 124 units · 71 projects · strata mid
|
|
16
|
+
body: work/wild/units/aaddrick-claude-desktop-debian/0001-log.sh
|
|
17
|
+
query: jq -r 'select(.family == "aaddrick-claude-desktop-debian/0001-log") | .name' work/wild/names.jsonl
|
|
18
|
+
|
|
19
|
+
### Dynamic Theme Color Updating — The functions update configuration files for polybar and rofi to apply new color schemes.
|
|
20
|
+
|
|
21
|
+
wild: 76 units · 2 projects · strata mid
|
|
22
|
+
body: work/wild/units/adi1090x-polybar-themes/0003-change_color.sh
|
|
23
|
+
query: jq -r 'select(.family == "adi1090x-polybar-themes/0003-change_color") | .name' work/wild/names.jsonl
|
|
24
|
+
|
|
25
|
+
### Logging Warnings — These functions are part of a cluster of shell scripts that provide standardized logging ...
|
|
26
|
+
|
|
27
|
+
wild: 76 units · 50 projects · strata mid
|
|
28
|
+
body: work/wild/units/0xnyk-council-of-high-intelligence/0005-warn.sh
|
|
29
|
+
query: jq -r 'select(.family == "0xnyk-council-of-high-intelligence/0005-warn") | .name' work/wild/names.jsonl
|
|
30
|
+
|
|
31
|
+
### Status Reporting — These functions provide a shell script output for a test result or status.
|
|
32
|
+
|
|
33
|
+
wild: 38 units · 21 projects · strata mid
|
|
34
|
+
body: work/wild/units/0xax-asm/0002-pass.sh
|
|
35
|
+
query: jq -r 'select(.family == "0xax-asm/0002-pass") | .name' work/wild/names.jsonl
|
|
36
|
+
|
|
37
|
+
### Interactive Menu Display — These functions present a user-oriented menu for selecting options or actions within a ...
|
|
38
|
+
|
|
39
|
+
wild: 32 units · 17 projects · strata mid
|
|
40
|
+
body: work/wild/units/2cd-zsh/0128-restore_menu.sh
|
|
41
|
+
query: jq -r 'select(.family == "2cd-zsh/0128-restore_menu") | .name' work/wild/names.jsonl
|
|
42
|
+
|
|
43
|
+
### Usage Information — Both functions provide instructions on how to get started and the correct syntax for ...
|
|
44
|
+
|
|
45
|
+
wild: 30 units · 20 projects · strata blob
|
|
46
|
+
body: work/wild/units/21y4d-nmapautomator/0001-usage.sh
|
|
47
|
+
query: jq -r 'select(.family == "21y4d-nmapautomator/0001-usage") | .name' work/wild/names.jsonl
|
|
48
|
+
|
|
49
|
+
### Logging and Skipping — These functions provide a loop-based skipping mechanism that prints a status message and ...
|
|
50
|
+
|
|
51
|
+
wild: 27 units · 8 projects · strata mid
|
|
52
|
+
body: work/wild/units/archive228-loopkit/0004-skip.sh
|
|
53
|
+
query: jq -r 'select(.family == "archive228-loopkit/0004-skip") | .name' work/wild/names.jsonl
|
|
54
|
+
|
|
55
|
+
### Display Header — These functions are used to print a decorative header or introductory text to the user.
|
|
56
|
+
|
|
57
|
+
wild: 23 units · 19 projects · strata mid
|
|
58
|
+
body: work/wild/units/alirezarezvani-claude-code-tresor/0004-header.sh
|
|
59
|
+
query: jq -r 'select(.family == "alirezarezvani-claude-code-tresor/0004-header") | .name' work/wild/names.jsonl
|
|
60
|
+
|
|
61
|
+
### Colorized Output — These functions provide a ANSI escape code for red text output in a shell script.
|
|
62
|
+
|
|
63
|
+
wild: 21 units · 12 projects · strata mid
|
|
64
|
+
body: work/wild/units/233boy-v2ray/0001-_red.sh
|
|
65
|
+
query: jq -r 'select(.family == "233boy-v2ray/0001-_red") | .name' work/wild/names.jsonl
|
|
66
|
+
|
|
67
|
+
### Logging Success — These functions provide a formatted output for reporting successful operations.
|
|
68
|
+
|
|
69
|
+
wild: 20 units · 16 projects · strata mid
|
|
70
|
+
body: work/wild/units/alsyundawy-microsoft-office-for-macos/0002-log_success.sh
|
|
71
|
+
query: jq -r 'select(.family == "alsyundawy-microsoft-office-for-macos/0002-log_success") | .name' work/wild/names.jsonl
|
|
72
|
+
|
|
73
|
+
### Banner Display — These functions are part of a cluster of shell scripts that display a ASCII art banner ...
|
|
74
|
+
|
|
75
|
+
wild: 18 units · 13 projects · strata mid
|
|
76
|
+
body: work/wild/units/adam-sizzler-marz-reverse-proxy/0015-banner_1.sh
|
|
77
|
+
query: jq -r 'select(.family == "adam-sizzler-marz-reverse-proxy/0015-banner_1") | .name' work/wild/names.jsonl
|
|
78
|
+
|
|
79
|
+
### Logging and Display — These functions provide a formatted output for status messages or status updates.
|
|
80
|
+
|
|
81
|
+
wild: 18 units · 9 projects · strata mid
|
|
82
|
+
body: work/wild/units/andrewnakas-skate3-ios-setup/0001-say.sh
|
|
83
|
+
query: jq -r 'select(.family == "andrewnakas-skate3-ios-setup/0001-say") | .name' work/wild/names.jsonl
|
|
84
|
+
|
|
85
|
+
### Logging Wrapper — These functions provide a conditional logging mechanism that only prints output if a ...
|
|
86
|
+
|
|
87
|
+
wild: 16 units · 2 projects · strata mid
|
|
88
|
+
body: work/wild/units/nginx-docker-nginx/0011-entrypoint_log.sh
|
|
89
|
+
query: jq -r 'select(.family == "nginx-docker-nginx/0011-entrypoint_log") | .name' work/wild/names.jsonl
|
|
90
|
+
|
|
91
|
+
### Network Information Retrieval — These functions retrieve external IP addresses or server metadata from remote endpoints.
|
|
92
|
+
|
|
93
|
+
wild: 15 units · 11 projects · strata mid
|
|
94
|
+
body: work/wild/units/233boy-v2ray/0016-get_ip.sh
|
|
95
|
+
query: jq -r 'select(.family == "233boy-v2ray/0016-get_ip") | .name' work/wild/names.jsonl
|
|
96
|
+
|
|
97
|
+
### Logging and Formatting — These functions provide a stylized, and a consistent way to provide visual feedback to ...
|
|
98
|
+
|
|
99
|
+
wild: 12 units · 10 projects · strata mid
|
|
100
|
+
body: work/wild/units/archive228-loopkit/0002-step.sh
|
|
101
|
+
query: jq -r 'select(.family == "archive228-loopkit/0002-step") | .name' work/wild/names.jsonl
|
|
102
|
+
|
|
103
|
+
### Debug Logging — This function conditionally executes various logging mechanisms (standard, syslog, and ...
|
|
104
|
+
|
|
105
|
+
wild: 11 units · 10 projects · strata mid
|
|
106
|
+
canon: Debug Logging — rank-1 acmesh-official-acme.sh/0011-_debug (13 lines, sc/line 0); 2 exemplars
|
|
107
|
+
sverka: 2 связей → Debug Logging (0.74)
|
|
108
|
+
query: toonq -f '.[] | select(.family == "Debug Logging") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
109
|
+
body: work/units/acmesh-official-acme.sh/0011-_debug.sh
|
|
110
|
+
body: work/wild/units/acmesh-official-acme.sh/0011-_debug.sh
|
|
111
|
+
|
|
112
|
+
### Status Verification — These functions check the integrity and success of previous steps in a deployment or ...
|
|
113
|
+
|
|
114
|
+
wild: 10 units · 7 projects · strata mid
|
|
115
|
+
body: work/wild/units/233boy-v2ray/0017-check_status.sh
|
|
116
|
+
query: jq -r 'select(.family == "233boy-v2ray/0017-check_status") | .name' work/wild/names.jsonl
|
|
117
|
+
|
|
118
|
+
### Job Message Logging — Functions provide colored, level-specific logging for job status and messages to stderr.
|
|
119
|
+
|
|
120
|
+
canon: Job Message Logging — rank-1 poudriere/0019-_msg_dev (9 lines, sc/line 0); 8 exemplars
|
|
121
|
+
sverka: канон-специфична (связей нет)
|
|
122
|
+
query: toonq -f '.[] | select(.family == "Job Message Logging") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
123
|
+
body: work/units/poudriere/0019-_msg_dev.sh
|
|
124
|
+
|
|
125
|
+
### Display Help — These functions provide usage instructions and command-line options for a script.
|
|
126
|
+
|
|
127
|
+
wild: 6 units · 5 projects · strata blob
|
|
128
|
+
body: work/wild/units/233boy-v2ray/0013-show_help.sh
|
|
129
|
+
query: jq -r 'select(.family == "233boy-v2ray/0013-show_help") | .name' work/wild/names.jsonl
|
|
130
|
+
|
|
131
|
+
### Display Help Information — These functions provide usage instructions and command-line options for their respective ...
|
|
132
|
+
|
|
133
|
+
wild: 6 units · 2 projects · strata mid
|
|
134
|
+
body: work/wild/units/pi-hole-pi-hole/0010-helpFunc.sh
|
|
135
|
+
query: jq -r 'select(.family == "pi-hole-pi-hole/0010-helpFunc") | .name' work/wild/names.jsonl
|
|
136
|
+
|
|
137
|
+
### Update IKEv2 Logs — This function modifies the IKEv2 setup log file to reflect a new server address.
|
|
138
|
+
|
|
139
|
+
canon: Update IKEv2 Logs — rank-1 hwdsl2-setup-ipsec-vpn/0035-update_ikev2_conf (17 lines, sc/line 0); 6 exemplars
|
|
140
|
+
sverka: 6 связей → (цели — неназванные wild-кластеры)
|
|
141
|
+
query: toonq -f '.[] | select(.family == "Update IKEv2 Logs") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
142
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0035-update_ikev2_conf.sh
|
|
143
|
+
|
|
144
|
+
### Usage display — These functions extract and display the usage instructions from the source file.
|
|
145
|
+
|
|
146
|
+
wild: 6 units · 3 projects · strata blob
|
|
147
|
+
body: work/wild/units/codecentric-helm-charts/0020-usage.sh
|
|
148
|
+
query: jq -r 'select(.family == "codecentric-helm-charts/0020-usage") | .name' work/wild/names.jsonl
|
|
149
|
+
|
|
150
|
+
### VPN Setup Information — Displays current and target Libreswan versions and outlines the scope of configuration ...
|
|
151
|
+
|
|
152
|
+
canon: VPN Setup Information — rank-1 hwdsl2-setup-ipsec-vpn/0189-show_setup_info (43 lines, sc/line 0); 6 exemplars
|
|
153
|
+
sverka: 7 связей → (цели — неназванные wild-кластеры)
|
|
154
|
+
query: toonq -f '.[] | select(.family == "VPN Setup Information") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
155
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0189-show_setup_info.sh
|
|
156
|
+
|
|
157
|
+
### Tmux Message Display — This function displays a message in the tmux terminal and manages the display duration.
|
|
158
|
+
|
|
159
|
+
wild: 5 units · 4 projects · strata mid
|
|
160
|
+
body: work/wild/units/tmux-plugins-tmux-open/0002-display_message.sh
|
|
161
|
+
query: jq -r 'select(.family == "tmux-plugins-tmux-open/0002-display_message") | .name' work/wild/names.jsonl
|
|
162
|
+
|
|
163
|
+
### Visual Section Header — These functions provide a formatted, stylized visual separator or header for terminal ...
|
|
164
|
+
|
|
165
|
+
wild: 5 units · 5 projects · strata mid
|
|
166
|
+
body: work/wild/units/buildermethods-agent-os/0002-print_section.sh
|
|
167
|
+
query: jq -r 'select(.family == "buildermethods-agent-os/0002-print_section") | .name' work/wild/names.jsonl
|
|
168
|
+
|
|
169
|
+
### Debug Logging Function — This function conditionally logs arguments and hidden values based on various environment ...
|
|
170
|
+
|
|
171
|
+
canon: Debug Logging Function — rank-1 acmesh-official-acme.sh/0012-_secure_debug (20 lines, sc/line 0); 4 exemplars
|
|
172
|
+
sverka: 5 связей → Debug Logging (0.66)
|
|
173
|
+
query: toonq -f '.[] | select(.family == "Debug Logging Function") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
174
|
+
body: work/units/acmesh-official-acme.sh/0012-_secure_debug.sh
|
|
175
|
+
|
|
176
|
+
### Show VPN Setup Status — Displays confirmation of Libreswan installation and provides DNS configuration update ...
|
|
177
|
+
|
|
178
|
+
canon: Show VPN Setup Status — rank-1 hwdsl2-setup-ipsec-vpn/0197-show_setup_complete (24 lines, sc/line 0); 3 exemplars
|
|
179
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
180
|
+
query: toonq -f '.[] | select(.family == "Show VPN Setup Status") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
181
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0197-show_setup_complete.sh
|
|
182
|
+
|
|
183
|
+
### Check Temporary Status — Determines if a shellspec is marked as temporary based on specific environment variables.
|
|
184
|
+
|
|
185
|
+
canon: Check Temporary Status — rank-1 shellspec/0058-shellspec_is_temporary_skip (4 lines, sc/line 0); 2 exemplars
|
|
186
|
+
sverka: канон-специфична (связей нет)
|
|
187
|
+
query: toonq -f '.[] | select(.family == "Check Temporary Status") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
188
|
+
body: work/units/shellspec/0058-shellspec_is_temporary_skip.sh
|
|
189
|
+
|
|
190
|
+
### Client Status Print — Prints a message indicating the status (revoked or deleted) of a specified client.
|
|
191
|
+
|
|
192
|
+
canon: Client Status Print — rank-1 hwdsl2-setup-ipsec-vpn/0128-print_client_revoked (5 lines, sc/line 0); 2 exemplars
|
|
193
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
194
|
+
query: toonq -f '.[] | select(.family == "Client Status Print") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
195
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0128-print_client_revoked.sh
|
|
196
|
+
|
|
197
|
+
### Format Message Output — Formats and prints messages with optional elapsed time and color support
|
|
198
|
+
|
|
199
|
+
canon: Format Message Output — rank-1 poudriere/0013-_msg_fmt_n (74 lines, sc/line 0); 2 exemplars
|
|
200
|
+
sverka: канон-специфична (связей нет)
|
|
201
|
+
query: toonq -f '.[] | select(.family == "Format Message Output") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
202
|
+
body: work/units/poudriere/0013-_msg_fmt_n.sh
|
|
203
|
+
|
|
204
|
+
### Get Server IP — Determines the server's public IP address, prioritizing configured variables or default ...
|
|
205
|
+
|
|
206
|
+
canon: Get Server IP — rank-1 hwdsl2-setup-ipsec-vpn/0030-get_server_ip (9 lines, sc/line 0); 2 exemplars
|
|
207
|
+
sverka: 1 связей → Network Information Retrieval (0.85)
|
|
208
|
+
query: toonq -f '.[] | select(.family == "Get Server IP") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
209
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0030-get_server_ip.sh
|
|
210
|
+
|
|
211
|
+
### Job Warning Message — Prints a warning message prefixed with a specific color and label.
|
|
212
|
+
|
|
213
|
+
canon: Job Warning Message — rank-1 poudriere/0021-msg_warn (15 lines, sc/line 0); 2 exemplars
|
|
214
|
+
sverka: канон-специфична (связей нет)
|
|
215
|
+
query: toonq -f '.[] | select(.family == "Job Warning Message") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
216
|
+
body: work/units/poudriere/0021-msg_warn.sh
|
|
217
|
+
|
|
218
|
+
### Logging Output — Functions write variable or positional arguments to a specified log file or standard ...
|
|
219
|
+
|
|
220
|
+
canon: Logging Output — rank-1 acmesh-official-acme.sh/0006-_log (5 lines, sc/line 0); 2 exemplars
|
|
221
|
+
sverka: 2 связей → Logging and Output (0.72)
|
|
222
|
+
query: toonq -f '.[] | select(.family == "Logging Output") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
223
|
+
body: work/units/acmesh-official-acme.sh/0006-_log.sh
|
|
224
|
+
|
|
225
|
+
### Message Formatting — Functions format and output messages using a common internal helper function.
|
|
226
|
+
|
|
227
|
+
canon: Message Formatting — rank-1 poudriere/0015-msg_n (4 lines, sc/line 0); 2 exemplars
|
|
228
|
+
sverka: 1 связей → (цели — неназванные wild-кластеры)
|
|
229
|
+
query: toonq -f '.[] | select(.family == "Message Formatting") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
230
|
+
body: work/units/poudriere/0015-msg_n.sh
|
|
231
|
+
|
|
232
|
+
### Removal Status Printer — Prints a confirmation message indicating that a specific VPN component has been removed.
|
|
233
|
+
|
|
234
|
+
canon: Removal Status Printer — rank-1 hwdsl2-setup-ipsec-vpn/0139-print_ikev2_removed (5 lines, sc/line 0); 2 exemplars
|
|
235
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
236
|
+
query: toonq -f '.[] | select(.family == "Removal Status Printer") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
237
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0139-print_ikev2_removed.sh
|
|
238
|
+
|
|
239
|
+
### Select Menu Option — Presents a numbered menu and validates user input against a predefined set of choices.
|
|
240
|
+
|
|
241
|
+
canon: Select Menu Option — rank-1 hwdsl2-setup-ipsec-vpn/0054-select_menu_option (16 lines, sc/line 0); 2 exemplars
|
|
242
|
+
sverka: 2 связей → Interactive Menu Display (0.67)
|
|
243
|
+
query: toonq -f '.[] | select(.family == "Select Menu Option") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
244
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0054-select_menu_option.sh
|
|
245
|
+
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- GENERATED by shell-atlas bin/handbook (mk handbook). Hand edits WILL be overwritten. as-of: 5539bbbe9ebc 2026-11-08 -->
|
|
2
|
+
|
|
3
|
+
# Errors & exit — measured shell idioms
|
|
4
|
+
|
|
5
|
+
6 families (canon ∪ wild join view). as-of 2026-11-08. Index: [index.md](../index.md) · [family-index.md](../family-index.md).
|
|
6
|
+
|
|
7
|
+
### Error reporting — These functions provide a user-friendly way to send a user-friendly way to send a ...
|
|
8
|
+
|
|
9
|
+
wild: 297 units · 119 projects · strata mid
|
|
10
|
+
body: work/wild/units/0xax-asm/0001-fail.sh
|
|
11
|
+
query: jq -r 'select(.family == "0xax-asm/0001-fail") | .name' work/wild/names.jsonl
|
|
12
|
+
|
|
13
|
+
### Error Handling Function — Provides a standardized way to print an error message and exit the script with a failure ...
|
|
14
|
+
|
|
15
|
+
canon: Error Handling Function — rank-1 hwdsl2-setup-ipsec-vpn/0001-exiterr (2 lines, sc/line 0); 16 exemplars
|
|
16
|
+
sverka: 1 связей → Error reporting (0.85)
|
|
17
|
+
query: toonq -f '.[] | select(.family == "Error Handling Function") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
18
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0001-exiterr.sh
|
|
19
|
+
|
|
20
|
+
### Abort and Exit — Exits the script with a failure status after notifying the user that no changes were made.
|
|
21
|
+
|
|
22
|
+
wild: 10 units · 5 projects · strata mid
|
|
23
|
+
canon: Abort and Exit — rank-1 hwdsl2-setup-ipsec-vpn/0024-abort_and_exit (5 lines, sc/line 0); 4 exemplars
|
|
24
|
+
sverka: 1 связей → Abort and Exit (0.86)
|
|
25
|
+
query: toonq -f '.[] | select(.family == "Abort and Exit") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
26
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0024-abort_and_exit.sh
|
|
27
|
+
body: work/wild/units/hwdsl2-setup-ipsec-vpn/0024-abort_and_exit.sh
|
|
28
|
+
|
|
29
|
+
### Confirm Exit — The function provides a user confirmation prompt before exiting a process.
|
|
30
|
+
|
|
31
|
+
wild: 8 units · 2 projects · strata mid
|
|
32
|
+
body: work/wild/units/adi1090x-rofi/0019-confirm_exit.sh
|
|
33
|
+
query: jq -r 'select(.family == "adi1090x-rofi/0019-confirm_exit") | .name' work/wild/names.jsonl
|
|
34
|
+
|
|
35
|
+
### Handle installation failure — This function reports a failure during package installation using different package ...
|
|
36
|
+
|
|
37
|
+
canon: Handle installation failure — rank-1 hwdsl2-setup-ipsec-vpn/0181-exiterr2 (2 lines, sc/line 0); 6 exemplars
|
|
38
|
+
sverka: 6 связей → (цели — неназванные wild-кластеры)
|
|
39
|
+
query: toonq -f '.[] | select(.family == "Handle installation failure") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
40
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0181-exiterr2.sh
|
|
41
|
+
|
|
42
|
+
### Configure Fail2Ban — Installs and configures Fail2Ban to protect SSH services.
|
|
43
|
+
|
|
44
|
+
canon: Configure Fail2Ban — rank-1 hwdsl2-setup-ipsec-vpn/0281-install_fail2ban (8 lines, sc/line 0); 4 exemplars
|
|
45
|
+
sverka: 4 связей → (цели — неназванные wild-кластеры)
|
|
46
|
+
query: toonq -f '.[] | select(.family == "Configure Fail2Ban") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
47
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0281-install_fail2ban.sh
|
|
48
|
+
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
<!-- GENERATED by shell-atlas bin/handbook (mk handbook). Hand edits WILL be overwritten. as-of: 5539bbbe9ebc 2026-11-08 -->
|
|
2
|
+
|
|
3
|
+
# Installation & setup — measured shell idioms
|
|
4
|
+
|
|
5
|
+
26 families (canon ∪ wild join view). as-of 2026-11-08. Index: [index.md](../index.md) · [family-index.md](../family-index.md).
|
|
6
|
+
|
|
7
|
+
### Install Application — Installs specified software packages using detected system package managers.
|
|
8
|
+
|
|
9
|
+
canon: Install Application — rank-1 christitustech-linutil/0001-installAlacritty (22 lines, sc/line 0); 89 exemplars
|
|
10
|
+
sverka: 75 связей → Software Uninstallation (0.69)
|
|
11
|
+
query: toonq -f '.[] | select(.family == "Install Application") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
12
|
+
body: work/units/christitustech-linutil/0001-installAlacritty.sh
|
|
13
|
+
|
|
14
|
+
### DNS Record Management — Functions manage the creation and deletion of DNS TXT records across various providers.
|
|
15
|
+
|
|
16
|
+
canon: DNS Record Management — rank-1 acmesh-official-acme.sh/0031-dns_ionos_cloud_add (19 lines, sc/line 0); 73 exemplars
|
|
17
|
+
sverka: 79 связей → Software Installation and Configuration (0.71)
|
|
18
|
+
query: toonq -f '.[] | select(.family == "DNS Record Management") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
19
|
+
body: work/units/acmesh-official-acme.sh/0031-dns_ionos_cloud_add.sh
|
|
20
|
+
|
|
21
|
+
### Software Installation and Configuration — These scripts are designed to automate the deployment and configuration of ...
|
|
22
|
+
|
|
23
|
+
wild: 73 units · 47 projects · strata blob
|
|
24
|
+
body: work/wild/units/1n3-sn1per/0021-main.sh
|
|
25
|
+
query: jq -r 'select(.family == "1n3-sn1per/0021-main") | .name' work/wild/names.jsonl
|
|
26
|
+
|
|
27
|
+
### Interactive Installer — These functions perform a user- or user-selected option-based installation or ...
|
|
28
|
+
|
|
29
|
+
wild: 64 units · 17 projects · strata blob
|
|
30
|
+
body: work/wild/units/adi1090x-polybar-themes/0106-main.sh
|
|
31
|
+
query: jq -r 'select(.family == "adi1090x-polybar-themes/0106-main") | .name' work/wild/names.jsonl
|
|
32
|
+
|
|
33
|
+
### Software Uninstallation — These functions provide a way to get rid of a user-slecteded user-s told or system-wide ...
|
|
34
|
+
|
|
35
|
+
wild: 46 units · 18 projects · strata mid
|
|
36
|
+
body: work/wild/units/christitustech-linutil/0045-uninstallArdour.sh
|
|
37
|
+
query: jq -r 'select(.family == "christitustech-linutil/0045-uninstallArdour") | .name' work/wild/names.jsonl
|
|
38
|
+
|
|
39
|
+
### App Setup Menu — Presents a menu to choose between installing, uninstalling, or managing a specific ...
|
|
40
|
+
|
|
41
|
+
canon: App Setup Menu — rank-1 christitustech-linutil/0012-main (13 lines, sc/line 0); 44 exemplars
|
|
42
|
+
sverka: 37 связей → Interactive Installer (0.85)
|
|
43
|
+
query: toonq -f '.[] | select(.family == "App Setup Menu") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
44
|
+
body: work/units/christitustech-linutil/0012-main.sh
|
|
45
|
+
|
|
46
|
+
### Toolchain Setup — These functions initialize and install necessary software components and environment ...
|
|
47
|
+
|
|
48
|
+
wild: 27 units · 25 projects · strata blob
|
|
49
|
+
body: work/wild/units/1n3-sn1per/0015-install_python_tools.sh
|
|
50
|
+
query: jq -r 'select(.family == "1n3-sn1per/0015-install_python_tools") | .name' work/wild/names.jsonl
|
|
51
|
+
|
|
52
|
+
### Environment Variable Expansion — These functions allow a user to define a system variable or a file path to its value, ...
|
|
53
|
+
|
|
54
|
+
wild: 16 units · 4 projects · strata mid
|
|
55
|
+
body: work/wild/units/kartoza-docker-geoserver/0028-file_env.sh
|
|
56
|
+
query: jq -r 'select(.family == "kartoza-docker-geoserver/0028-file_env") | .name' work/wild/names.jsonl
|
|
57
|
+
|
|
58
|
+
### Fetch latest release — Retrieves the latest version tag or name from a GitHub repository.
|
|
59
|
+
|
|
60
|
+
wild: 15 units · 12 projects · strata mid
|
|
61
|
+
body: work/wild/units/browserbox-browserbox/0022-get_latest_release.sh
|
|
62
|
+
query: jq -r 'select(.family == "browserbox-browserbox/0022-get_latest_release") | .name' work/wild/names.jsonl
|
|
63
|
+
|
|
64
|
+
### Docker Installation — The functions provide logic to either install the Docker engine or pull a pre-defined ...
|
|
65
|
+
|
|
66
|
+
wild: 14 units · 7 projects · strata mid
|
|
67
|
+
body: work/wild/units/christitustech-linutil/0110-install_docker.sh
|
|
68
|
+
query: jq -r 'select(.family == "christitustech-linutil/0110-install_docker") | .name' work/wild/names.jsonl
|
|
69
|
+
|
|
70
|
+
### Libreswan Setup — Downloads, extracts, and configures the Libreswan VPN package for installation.
|
|
71
|
+
|
|
72
|
+
canon: Libreswan Setup — rank-1 hwdsl2-setup-ipsec-vpn/0192-get_libreswan (14 lines, sc/line 0); 12 exemplars
|
|
73
|
+
sverka: 12 связей → (цели — неназванные wild-кластеры)
|
|
74
|
+
query: toonq -f '.[] | select(.family == "Libreswan Setup") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
75
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0192-get_libreswan.sh
|
|
76
|
+
|
|
77
|
+
### Update Network Firewall Rules — The function removes or updates iptables/nftables rules related to the hwdsl2 VPN script ...
|
|
78
|
+
|
|
79
|
+
canon: Update Network Firewall Rules — rank-1 hwdsl2-setup-ipsec-vpn/0162-update_sysctl (29 lines, sc/line 0); 9 exemplars
|
|
80
|
+
sverka: 12 связей → Toolchain Setup (0.68)
|
|
81
|
+
query: toonq -f '.[] | select(.family == "Update Network Firewall Rules") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
82
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0162-update_sysctl.sh
|
|
83
|
+
|
|
84
|
+
### Go Environment Setup — These functions are designed to handle the installation and configuration of the ...
|
|
85
|
+
|
|
86
|
+
wild: 8 units · 2 projects · strata mid
|
|
87
|
+
body: work/wild/units/1n3-sn1per/0010-setup_go.sh
|
|
88
|
+
query: jq -r 'select(.family == "1n3-sn1per/0010-setup_go") | .name' work/wild/names.jsonl
|
|
89
|
+
|
|
90
|
+
### Software Installation — These functions perform the setup and deployment of software components or dependencies ...
|
|
91
|
+
|
|
92
|
+
wild: 5 units · 5 projects · strata blob
|
|
93
|
+
body: work/wild/units/community-scripts-proxmoxve/0144-install.sh
|
|
94
|
+
query: jq -r 'select(.family == "community-scripts-proxmoxve/0144-install") | .name' work/wild/names.jsonl
|
|
95
|
+
|
|
96
|
+
### Check LXC Environment — Verifies if the required /dev/ppp device exists when the container type is set to lxc.
|
|
97
|
+
|
|
98
|
+
canon: Check LXC Environment — rank-1 hwdsl2-setup-ipsec-vpn/0246-check_lxc (11 lines, sc/line 0); 3 exemplars
|
|
99
|
+
sverka: 3 связей → (цели — неназванные wild-кластеры)
|
|
100
|
+
query: toonq -f '.[] | select(.family == "Check LXC Environment") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
101
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0246-check_lxc.sh
|
|
102
|
+
|
|
103
|
+
### Install Container Compose — Installs the appropriate container orchestration tool (Docker Compose or Podman Compose) ...
|
|
104
|
+
|
|
105
|
+
canon: Install Container Compose — rank-1 christitustech-linutil/0111-install_docker_compose (35 lines, sc/line 0); 3 exemplars
|
|
106
|
+
sverka: 3 связей → Docker Installation (0.80)
|
|
107
|
+
query: toonq -f '.[] | select(.family == "Install Container Compose") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
108
|
+
body: work/units/christitustech-linutil/0111-install_docker_compose.sh
|
|
109
|
+
|
|
110
|
+
### Setup Fastfetch — Installs Fastfetch using system package managers and sets up default configuration files.
|
|
111
|
+
|
|
112
|
+
canon: Setup Fastfetch — rank-1 christitustech-linutil/0114-installFastfetch (35 lines, sc/line 0); 3 exemplars
|
|
113
|
+
sverka: 3 связей → (цели — неназванные wild-кластеры)
|
|
114
|
+
query: toonq -f '.[] | select(.family == "Setup Fastfetch") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
115
|
+
body: work/units/christitustech-linutil/0114-installFastfetch.sh
|
|
116
|
+
|
|
117
|
+
### API Interaction — Functions execute HTTP requests to external APIs using specific authentication and ...
|
|
118
|
+
|
|
119
|
+
canon: API Interaction — rank-1 acmesh-official-acme.sh/0056-jd_rest (121 lines, sc/line 0); 2 exemplars
|
|
120
|
+
sverka: 25 связей → Software Installation and Configuration (0.74)
|
|
121
|
+
query: toonq -f '.[] | select(.family == "API Interaction") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
122
|
+
body: work/units/acmesh-official-acme.sh/0056-jd_rest.sh
|
|
123
|
+
|
|
124
|
+
### Environment Directory Setup — Creates a directory and populates it with environment variables from the current shell ...
|
|
125
|
+
|
|
126
|
+
canon: Environment Directory Setup — rank-1 openrc/0010-_s6_make_envdir (24 lines, sc/line 0); 2 exemplars
|
|
127
|
+
sverka: канон-специфична (связей нет)
|
|
128
|
+
query: toonq -f '.[] | select(.family == "Environment Directory Setup") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
129
|
+
body: work/units/openrc/0010-_s6_make_envdir.sh
|
|
130
|
+
|
|
131
|
+
### Install Application Files — Downloads and places necessary application files like manpages and desktop entries to ...
|
|
132
|
+
|
|
133
|
+
canon: Install Application Files — rank-1 christitustech-linutil/0121-install_extra (12 lines, sc/line 0); 2 exemplars
|
|
134
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
135
|
+
query: toonq -f '.[] | select(.family == "Install Application Files") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
136
|
+
body: work/units/christitustech-linutil/0121-install_extra.sh
|
|
137
|
+
|
|
138
|
+
### Install Communication Apps — Installs specified communication applications using package managers like pacman or ...
|
|
139
|
+
|
|
140
|
+
canon: Install Communication Apps — rank-1 christitustech-linutil/0039-installZapZap (17 lines, sc/line 0); 2 exemplars
|
|
141
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
142
|
+
query: toonq -f '.[] | select(.family == "Install Communication Apps") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
143
|
+
body: work/units/christitustech-linutil/0039-installZapZap.sh
|
|
144
|
+
|
|
145
|
+
### Install Developer IDE — Installs either VS Code or VS Codium using system package managers (apt, zypper, pacman, ...
|
|
146
|
+
|
|
147
|
+
canon: Install Developer IDE — rank-1 christitustech-linutil/0106-installVsCode (42 lines, sc/line 0); 2 exemplars
|
|
148
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
149
|
+
query: toonq -f '.[] | select(.family == "Install Developer IDE") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
150
|
+
body: work/units/christitustech-linutil/0106-installVsCode.sh
|
|
151
|
+
|
|
152
|
+
### Install PDF Components — Checks for and installs specific PDF-related applications from remote scripts.
|
|
153
|
+
|
|
154
|
+
canon: Install PDF Components — rank-1 christitustech-linutil/0140-installPdfstudio (16 lines, sc/line 0); 2 exemplars
|
|
155
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
156
|
+
query: toonq -f '.[] | select(.family == "Install PDF Components") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
157
|
+
body: work/units/christitustech-linutil/0140-installPdfstudio.sh
|
|
158
|
+
|
|
159
|
+
### Install UUID Generator — Ensures the `uuidgen` command is available by installing necessary packages based on the ...
|
|
160
|
+
|
|
161
|
+
canon: Install UUID Generator — rank-1 hwdsl2-setup-ipsec-vpn/0110-install_base64_uuidgen (24 lines, sc/line 0); 2 exemplars
|
|
162
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
163
|
+
query: toonq -f '.[] | select(.family == "Install UUID Generator") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
164
|
+
body: work/units/hwdsl2-setup-ipsec-vpn/0110-install_base64_uuidgen.sh
|
|
165
|
+
|
|
166
|
+
### Setup RetroArch — Installs and configures the RetroArch emulator and its necessary libretro cores across ...
|
|
167
|
+
|
|
168
|
+
canon: Setup RetroArch — rank-1 christitustech-linutil/0217-installRetroArch (20 lines, sc/line 0); 2 exemplars
|
|
169
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
170
|
+
query: toonq -f '.[] | select(.family == "Setup RetroArch") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
171
|
+
body: work/units/christitustech-linutil/0217-installRetroArch.sh
|
|
172
|
+
|
|
173
|
+
### Waydroid setup — Initializes and enables the Waydroid container service
|
|
174
|
+
|
|
175
|
+
canon: Waydroid setup — rank-1 christitustech-linutil/0152-installWaydroid (62 lines, sc/line 0); 2 exemplars
|
|
176
|
+
sverka: 2 связей → (цели — неназванные wild-кластеры)
|
|
177
|
+
query: toonq -f '.[] | select(.family == "Waydroid setup") | [.rank,.project,.unit,.lines,.sc_per_line]' work/cards.toon
|
|
178
|
+
body: work/units/christitustech-linutil/0152-installWaydroid.sh
|
|
179
|
+
|