Hiding docs/scrolls/

Some projects run their scrolls folder visible (scrolls, e.g. via /scrolls-setup --unhide or a prior /scrolls-unhide) and later want it back to the dotfile-hidden default. This skill renames scrolls → .scrolls and fixes every reference to the old path that it can find with confidence, without guessing at edits to files outside its scope. It's the mirror image of /scrolls-unhide — same mechanics, opposite direction.

Everything operates relative to the current working directory unless -t/--reporoot says otherwise — not relative to this skill's own location.

Cross-platform

The bundled script ships in two forms: hide.sh (bash — macOS, Linux, or Windows with Git Bash/WSL) and hide.ps1 (PowerShell 7+ — Windows, or macOS/Linux with pwsh installed). Both accept the exact same flags in the exact same forms (-p/--path, -t/--reporoot, -l/--local, -r/--recurse) and produce the same output — only the launcher differs. Pick by what's actually available: try bash --version; if that succeeds, use .sh; otherwise use .ps1 via pwsh (preferred — install from https://aka.ms/powershell if missing) or, only if pwsh genuinely isn't available, the built-in Windows PowerShell powershell.exe (untested against that older version; pwsh is what this was written and verified against).

Options

Read the invocation text for these, in any order — there's no real argv parser here, so pull them out of the plain text yourself:

• -p <path> / --path=<path> / --path <path> — a base directory to operate on, instead of the current directory. Repeatable, to target several locations in one run (e.g. -p packages/api -p packages/web in a monorepo).
• -t / --reporoot — use the git repository's top level ($(git rev-parse --show-toplevel)) as the base directory, regardless of which subdirectory you actually invoked this from. Fails with a clear message if the current directory isn't inside a git repository.
• -l / --local — use the current working directory as the base directory explicitly. This is what happens by default anyway when none of -p/-t/-l are given — the flag exists to say so on purpose.
• -r / --recurse — search recursively under the base directory for scrolls folders, instead of checking only its exact docs/scrolls. Matches the usual meaning of -r on tools like grep/cp/rm: off by default, opt in to widen the blast radius. Combine with any of the above (or with none, recursing from cwd).