Menu
Scaffold a new helper script in local/bin/ with proper boilerplate, msgr sourcing, and documentation tag.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | new-script |
| description | Scaffold a new helper script in local/bin/ with proper boilerplate, msgr sourcing, and documentation tag. |
| user-invocable | true |
| allowed-tools | Bash, Read, Write, Edit |
When creating a new script in local/bin/, follow this template:
Create local/bin/<name> with:
#!/usr/bin/env bash
# @description <one-line description>
#USAGE about "<one-line description>"
set -euo pipefail
# shellcheck source=msgr
. "$(dirname "$0")/msgr"
# Script logic here
@description tag is required — dfm scripts discovers
scripts by it#USAGE about directive is required — install-completions.sh
discovers scripts by grep -q '#USAGE\|//USAGE'; scripts without it
get no completions, markdown docs, or manpages#USAGE flag, #USAGE arg, #USAGE cmd lines as needed
(see https://usage.jdx.dev/cli/scripts)msgr functions for output: msgr msg, msgr run,
msgr yay, msgr err, msgr warn/bin/sh) should NOT source msgrchmod +x local/bin/<name>
Run scripts/install-completions.sh to regenerate completions,
markdown docs, and manpages for all inline-annotated scripts in
local/bin/ and scripts/.
Run the shell-validate skill checks (syntax + shellcheck).
x- prefix for standalone utilities (e.g., x-ssl-expiry-date)a, ad, ae)git- prefix for git subcommands (e.g., git-dirty)Use for any question about a codebase, its architecture, file relationships, or project content — especially when graphify-out/ exists, where the question should be treated as a graphify query first. Turns any input (code, docs, papers, images, videos) into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools.
Scaffold a bats test file in tests/<script>.bats matching a script in local/bin/<script>. Use when adding tests for an existing script that lacks coverage.
Scaffold a new theme handler in config/theme/handlers.d/<app>. Use when adding dark/light theme support for an app the orchestrator does not yet flip.
Validate fish scripts after editing. Apply when writing or modifying any .fish file in config/fish/.
Scaffold a new fish function in config/fish/functions/ with proper conventions and event handling.
Deterministic adversarial code review focused on provable failures. Optimized for agent execution, minimal tokens, and high signal findings across web applications.