| name | scrolls-hide |
| description | Converts an already-set-up docs/scrolls/ working-memory folder from visible (scrolls) to dotfile-hidden (.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-hide, or asks to hide, dot, or re-hide the scrolls folder, go back to hiding project memory / docs/.scrolls, or rename scrolls to .scrolls. This is the retrofit path for a project that was set up visible and now wants it hidden — for a brand-new project, /scrolls-setup's default (no -u/--unhide flag) already creates it hidden 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-unhide. |
| 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-hide","type":"skill","author":"sugatoray","version":"2.1.0","source_url":"https://github.com/sugatoray/aiskills/tree/master/skills/scrolls/scrolls-hide"}] |
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.
