| name | scrolls-unhide |
| description | Converts an already-set-up docs/.scrolls/ working-memory folder from dotfile-hidden (.scrolls) to visible (scrolls), renaming the folder and rewriting the path references inside it and in SCROLLS.md so nothing breaks. Use this whenever the user runs /scrolls-unhide, or asks to unhide, un-dot, or show the scrolls folder, stop hiding project memory / docs/.scrolls, or rename .scrolls to scrolls. This is the retrofit path for a project that was set up hidden and now wants it visible — for a brand-new project, /scrolls-setup's own -u/--unhide flag does this in one step and this skill isn't needed. By default checks one exact location (docs/.scrolls under the current directory); supports -r/--recurse to sweep an entire directory tree instead (e.g. every package in a monorepo in one run), repeatable -p/--path to target specific locations, -t/--reporoot to target the git repository's top level regardless of which subdirectory you're in, -l/--local to target the current directory explicitly, and the DEFAULT_SCROLLS_RELPATH environment variable to change the default location. Works on macOS, Linux, and Windows (bash or PowerShell). The opposite of /scrolls-hide. |
| license | MIT |
| compatibility | bash (macOS/Linux/WSL) or PowerShell 7+ (pwsh) or PowerShell (older versions: powershell.exe); Python 3.9+ (stdlib only, no dependencies) |
| disable-model-invocation | true |
| metadata | [{"name":"scrolls-unhide","type":"skill","author":"sugatoray","version":"2.1.0","source_url":"https://github.com/sugatoray/aiskills/tree/master/skills/scrolls/scrolls-unhide"}] |
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 .scrolls → scrolls 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.
