scrolls-unhide

Installation
SKILL.md

Unhiding docs/.scrolls/

/scrolls-setup defaults to a dotfile-hidden .scrolls folder. Some projects would rather have it visible in a normal directory listing — this skill renames .scrollsscrolls on an existing setup 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-hide.

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: unhide.sh (bash — macOS, Linux, or Windows with Git Bash/WSL) and unhide.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).
Installs
130
GitHub Stars
4
First Seen
Aug 16, 2026
scrolls-unhide — sugatoray/aiskills