@litfamily/litgrok 1.0.9 → 1.0.10

package/.grok/skills/lit-typographic-motion/THIRD_PARTY_NOTICES

@@ -7,7 +7,7 @@ Engine
   The page shaders carry simplex noise by Ashima Arts and Stefan Gustavson (MIT).
 
 Engine dependencies (installed by `litgrok-ai motion-runtime install`, not shipped here)
-  opentype.js 1.3.4 (MIT), ws 8.18.3 (MIT), string.prototype.codepointat 0.2.1 (MIT),
+  opentype.js 1.3.4 (MIT), ws 8.22.0 (MIT), string.prototype.codepointat 0.2.1 (MIT),
   tiny-inflate 1.0.3 (MIT); licence texts install with each package in the motion cache.
   Tier 2 only: librosa and the packages pinned in requirements-audio.txt, installed with
   `--audio`; each package's licence installs with it in the audio venv.

package/.grok/skills/lit-typographic-motion/package-lock.json

@@ -7,7 +7,7 @@
       "name": "litgrok-motion-runtime",
       "dependencies": {
         "opentype.js": "1.3.4",
-        "ws": "8.18.3"
+        "ws": "8.22.0"
       }
     },
     "node_modules/opentype.js": {
@@ -39,9 +39,9 @@
       "license": "MIT"
     },
     "node_modules/ws": {
-      "version": "8.18.3",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz",
-      "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==",
+      "version": "8.22.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.22.0.tgz",
+      "integrity": "sha512-Ydggc987+RO0AnWtZ/7Wq9FtNvcrL1b/RO0ud9mWjUPgDrsAAwQSF51sm2hm1XofbU/4jkpGEsLFsZZxU+1DOg==",
       "license": "MIT",
       "engines": {
         "node": ">=10.0.0"

package/.grok/skills/lit-typographic-motion/package.json

@@ -5,6 +5,6 @@
   "description": "Pinned engine dependencies for lit-typographic-motion, installed only by litgrok-ai motion-runtime install.",
   "dependencies": {
     "opentype.js": "1.3.4",
-    "ws": "8.18.3"
+    "ws": "8.22.0"
   }
 }

package/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "litgrok",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Grok Build skills, project rules, and bounded lifecycle hooks for evidence-first lit work.",
   "author": {
     "name": "LitGrok contributors"

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 1.0.10 — 2026-09-29
+
+- lit-typographic-motion: the motion runtime now pins `ws` 8.22.0, which fixes a memory-exhaustion denial of service and an uninitialized-memory disclosure in 8.18.3. Run `litgrok-ai motion-runtime install` again after upgrading.
+- The npm package no longer picks up Python bytecode (`__pycache__`, `.pyc`) left in the lit-pptx and lit-docx script folders.
+- The READMEs are rewritten in plainer language, and GitHub and npmjs now get different pages: the full guide with the skills gallery stays on GitHub, and npmjs shows a shorter install-first page from `docs/npm/`, swapped in when the package is packed.
+
 ## 1.0.9 — 2026-09-28
 
 - lit-pptx: the second rich render style id is now `green`.

package/CONTRIBUTING.md

@@ -17,6 +17,8 @@ The suite includes package, installer, ownership, hooks, and static documentatio
 
 For a behavior change, preserve a failing regression and test the corrected path plus a meaningful refusal case. Exercise installations in a disposable project and HOME with separate TMPDIR and npm cache. Interactive writes require a terminal; CI and no-color modes remain no-write previews even with `--yes`. Never use a real user profile as a fixture. Preserve unrelated settings, changed skills, and unsafe destinations; clean only your own temporary resources.
 
+GitHub and npmjs show different READMEs. `README.md` and `README_ko-KR.md` are the GitHub pages and use repository-relative paths. The shorter npm pages live in `docs/npm/` and pin every image and file link to the package version on jsDelivr. `npm pack` swaps them in through the `prepack` and `postpack` scripts and puts the GitHub pages back afterwards. A release that packs or publishes with `--ignore-scripts` skips those scripts, so run `node scripts/readme-for-npm.mjs apply` right before it and `node scripts/readme-for-npm.mjs restore` right after it; run the test suite before `apply`, because the tests read the GitHub pages. `npm run check:npm-readme` checks the npm pages on their own.
+
 Keep npm identity separate from executable aliases and ownership IDs. Do not add dependencies, undocumented host surfaces, or an updater to solve a documentation change. Keep vendor bytes, license notices, accepted artwork, and unrelated changes intact. Product versions and release actions require a separate maintainer decision; CI validates only.
 
 In a pull request, state the trigger and resulting behavior, changed scope, checks with results, unresolved limitations, and cleanup. Remove secrets, transcript excerpts, identifying paths, and credentials from reports. See [security](./SECURITY.md), [privacy](./docs/privacy.md), and the [code of conduct](./CODE_OF_CONDUCT.md).

package/README.md

@@ -1,435 +1,102 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitGrok robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
-
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark — Grok" /></p>
-
-<details>
-<summary>Copy ASCII logo</summary>
-
-```text
-                             ▄▄▄▄
-                   ▗███▌   ▗██████▖
- ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
- ▐█████        ▗▟██████▌    ▝▀▜█▀▘
- ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
- ▐█████    ▗▟█████████████████████████ ▐█▀
- ▐█████    ████████████████████████████▀
- ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
- ▐█████    ▀    ▄██ ████▌█████████████▌
- ▐█████       ▄████ ████▌█████████████▌
- ▐█████     ▄█████▛
- ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
- ▐█████ ▐█████▀          █████     ▐▛▀
- ▐█████ ▐███▀            █████
- ▐█████ ▐█▀              █████
- ▐█████ ▝                █████
- ▐█████▄▄▄▄▄▄▄▖          █████
- ▐███████████▛           █████
- ▐██████████▀            █████
-
-
-grok
-```
-
-</details>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitGrok robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <h1 align="center">LitGrok</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 
 Make something useful in Grok Build. Leave the checked result and the next step with your project.
 
-[한국어](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/README_ko-KR.md) · [Install](#install-in-30-seconds) · [Quick start](#quick-start) · [Skills](#skills-at-a-glance) · [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md)
+**[Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litgrok#readme)** · [한국어](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md) · [Install](#install-in-30-seconds) · [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference.md)
 
 <p align="center">
-<a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/badge-version.svg" alt="1.0.9" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/badge-version.svg" alt="1.0.10" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install-in-30-seconds">Install</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install-in-30-seconds">Install</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
+
+LitGrok gives Grok Build a way of working: plan the change, build it, check it, and leave a handoff the next session can read. It ships 38 skills, 11 agents, one project rule, and eleven hook registrations. Grok Build still runs the session and chooses the model.
 
 ## Install in 30 seconds
 
-With Node.js and Grok Build available, use an open interactive terminal in the project you want to try. The primary install uses the scoped package:
+You need Node.js and Grok Build. In an interactive terminal, from the project you want to try:
 
 ```bash
 npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
 ```
 
-For an optional isolated trial, set the actual absolute path of the supplied local package, then run these two lines separately:
+The files land in `<project>/.grok/`. Add `--user` to install under `~/.grok/` instead, or use `--package @litfamily/litgrok@1.0.10` to pin this release. Add `--dry-run` to see every destination before anything is written.
+
+Trying a local package instead? Put its real absolute path in a variable, then run these two lines separately:
 
 ```bash
 LITGROK_PACK='/absolute/path/to/the-provided-package.tgz'
 npm exec --yes --package "$LITGROK_PACK" -- litgrok install
 ```
 
-The default destination is `<project>/.grok/`. Use `--package @litfamily/litgrok@1.0.9` for a pinned install, or add `--user` to install under `~/.grok/`. [Install and upgrade details](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#install).
-
-The persistent Grok status row is optional and user-level only. Opt in with:
-
-```bash
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok install --user --status-line
-```
-
-This adds `[ui.status_line]` to `~/.grok/config.toml` with a two-second refresh. If a config already exists, LitGrok backs it up before changing it; an existing `ui.status_line` is preserved. `uninstall --user` removes only the unchanged LitGrok-managed value. Grok reads this setting from user or administrator configuration, not from project or plugin configuration ([status-line docs](https://docs.x.ai/build/features/status-line), [settings reference](https://docs.x.ai/build/settings/reference)). Example rows are `🔥 LIT IGNITED · lit-plan 🔥 │ grok-4 │ ctx 42%` and `LIT · grok │ grok-4 │ ctx 42%`. The first visible prompt match among `lit-scientific-visualization`, `lit-handoff`, `autoconference`, `autoresearch`, `lit-plan`, and `litwork` sets the discipline; bare `lit` maps to `litwork`, and inline or fenced Markdown code is ignored. With color enabled, the active `LIT IGNITED · <discipline>` label is bold with a per-character truecolor gradient `#FF6337 → #FF2D95 → #00E5FF`; the flames and model/context segment remain unstyled. `NO_COLOR` (including an empty value) or `LITGROK_HUD_COLOR=0` keeps the row plain. Truecolor, bold and emoji rendering in the status row were confirmed on Grok Build 1.0.13. This adds a status command, not another hook registration; LitGrok still ships eleven hook registrations.
-
-### Safety and uninstall
-
-Preview the exact destinations before writing:
-
-```bash
-npm exec --yes --package "$LITGROK_PACK" -- litgrok install --dry-run
-```
-
-The installer verifies file ownership before upgrades or removal. Modified, foreign, or unsafe destination files cause the operation to refuse rather than overwrite them. `CI`, `NO_COLOR` (even empty), `--no-color`, and `--dry-run` are no-write previews regardless of `--yes`. Without `--yes`, a non-interactive run is also a no-write preview; with `--yes`, it proceeds without a TTY as long as none of the above apply.
-
-For a local-package install, remove it with the same package in the same project. Add `--user` only to remove an installation made with `--user`.
-
-```bash
-npm exec --yes --package "$LITGROK_PACK" -- litgrok uninstall
-```
-
-Registry uninstall commands:
-
-```bash
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
-```
-
-User-level uninstall backs up `~/.grok/config.toml` before removing the unchanged LitGrok-managed status-line keys; other settings and a user-edited status line are preserved. Match the scope used for installation. Re-run `install` to update. The installer does not grant hook trust, create a Git root, write login state or API keys, or choose a model. The hedge guard is fail-open on host errors; a passing package test does not prove live Grok behavior. Check `/hooks` and `grok inspect --json` from the repository root in your own session. [Host boundaries and verification](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#verify).
-
-## Quick start
+## The first thing to type
 
-Open or restart Grok Build at the installed project’s Git root. Review and trust its project hooks with `/hooks-trust`, or, on the observed Grok Build 1.0.23 host, use `grok --trust inspect --json`. A plain folder can still load skills and rules while hooks remain unavailable. Check `/skills` for the installed catalog and `/hooks` for hook registrations. LitGrok does not create a Git root or change trust.
-
-Start with a small task that needs no external service or existing test suite. Send this in Grok Build:
+Open or restart Grok Build at the project's Git root, then review and trust its hooks with `/hooks-trust` (on the observed Grok Build 1.0.23 host, `grok --trust inspect --json` also works). A plain folder still loads skills and rules, but its hooks stay unavailable. Then send:
 
 ```text
 /litwork Build a to-do list in one index.html with no external dependencies. Implement add, complete, and delete. Leave the checks performed and the next step. Do not open a browser automatically; give me the steps to check it myself.
 ```
 
-Open the generated `index.html` yourself and try adding, completing, and deleting an item. Creating a file and checking its behavior are separate steps. Leave any unrun checks marked unverified; report actual errors back to the session.
-
-### Carry the spark into the next session
+Open `index.html` yourself and try adding, completing, and deleting an item. Leave any check you did not run marked unverified.
 
-```text
-Plan → Build → Verify → Hand off
-```
+## Carry the work into the next session
 
-For a larger change, start with `/lit-plan`, review the saved plan, then invoke `/start-work <plan path>`. Before stopping, ask:
+For a larger change, start with `/lit-plan`, read the plan it saves, then run `/start-work <plan path>`. Before you stop, ask:
 
 ```text
 /lit-handoff Record what we built, what we checked, and what remains. Tell me where you saved the handoff.
 ```
 
-In the next session, supply that returned path and ask Grok Build to read it and check the current files before continuing. The default is `.handoff/HANDOFF.md` in a new Git project or `HANDOFF.md` in a non-Git workspace. An existing root handoff is reused. [Destination and handoff guidance](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/lit-handoff/SKILL.md).
-
-**Keeping the spark means leaving work another session can pick up.** These are skill-guided steps in your session; LitGrok does not schedule background work or continue after the session ends.
-
-## Key features
-
-> **A spark has been placed in your hands. Put it to work.**
->
-> A bug you want fixed. A screen you want built. A project you want to finish.
->
-> Starting takes a line. When the session changes, the harder part is finding where you left off. LIT guides you through leaving a goal, a plan, a checked result, and a next step with your project.
->
-> **Leave something the next session can pick up.**
-
-It ships 38 skills, 11 agents, one project rule, and eleven hook registrations. The installer copies the complete payload into your project; Grok Build runs the session and owns model selection.
+Next time, give Grok Build the path it returned and ask it to read the handoff and check the current files before continuing. A handoff does not resume anything on its own.
 
-Use `lit-humanizer` for longer edits or a Korean deep review. The pre-write guard checks newly added reader-facing prose: clear block-tier matches must be revised before saving, while warning-tier matches stay advisory. Created DOCX and PPTX files are checked after the tool runs; PDFs are checked with `pdftotext` when it is available. A missing extractor leaves the output unchanged and reports the inspection boundary.
+## Routes people use
 
-Check browser automation with `npm run probe:browser-drive`. LitGrok names [agent-browser](https://github.com/vercel-labs/agent-browser) as its CLI engine but never installs it for you. If the probe reports it missing, install it yourself with `npm install -g agent-browser` followed by `agent-browser install`.
-
-Package: `@litfamily/litgrok` · Version: `1.0.9` · [MIT](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE)
+| Type this | What happens |
+| --- | --- |
+| `/litwork` | Starts the shipped work checklist for a bounded task. |
+| `handoff` or `/lit-handoff` | Carries the checked result and the next step into another session. |
+| `/lit-plan` | Writes a plan with concrete checks. |
+| `/start-work <approved-plan>` | Executes a plan you approved. |
+| `/review-work` | Reviews a change and its evidence. |
+| `/litresearch` | Runs bounded, source-traceable research without overstating the evidence. |
 
-The scientific visualization corpus is packaged at `.grok/vendor/scientific-visualization/`; the numeric `045_scientific-visualization` label remains only in license and provenance filenames.
+`/skills` lists everything your session loaded. The [skills gallery on GitHub](https://github.com/wjgoarxiv/litgrok#skills-at-a-glance) shows all 38 with a picture of each result.
 
-These route examples are static guidance, not proof of live host behavior.
+Beyond code, `lit-pptx` makes slide decks, `lit-docx` makes reports and Word documents, `/frontend-ui-ux` builds and checks interfaces, `/readme-studio` writes source-checked READMEs, and `lit-humanizer` rewrites stiff English or Korean prose.
 
-The five activation contracts ask the model to start each activated response with exactly one line before other response content. For `/litwork`, the requested line is:
+## What changes after install
 
-🔥 **LIT IGNITED · litwork** 🔥
+The installer copies the skills, agents, project rule, and hooks into `.grok/`. The eleven hook registrations in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/hooks/hooks.json) run only in a trusted Git root, and they record the order of events in `.grok/litgrok/session-ledger/`. LitGrok does not schedule background work or keep going after the session ends.
 
-This is advisory prompt guidance; it does not verify native host display.
+An optional status row is available at user level with `install --user --status-line`. It adds `[ui.status_line]` to `~/.grok/config.toml` and backs up an existing file first.
 
-The retained `docs/assets/cover.svg` remains editable vector artwork; the README uses a still frame of the motion cover when reduced motion is preferred.
+## Safety and uninstall
 
-### How it fits inside Grok Build
+The installer checks that it owns a file before it upgrades or removes it, and refuses to overwrite modified, foreign, or unsafe files. `CI`, `NO_COLOR` (even empty), `--no-color`, and `--dry-run` are no-write previews, even with `--yes`. A non-interactive run without `--yes` is a preview too.
 
-The installer puts files in the project's `.grok/` directory. `/litwork` provides a checklist for the current session; Grok Build owns execution and model selection. These are the main connections.
+Uninstall with the same scope you installed with:
 
-```mermaid
-flowchart TD
-    I["litgrok install"] --> P["Project .grok/ files"]
-    P --> S["skills · /litwork"]
-    P --> R["rules · project guidance"]
-    P --> H["hooks · /hooks-trust required"]
-    S --> G["Grok Build session"]
-    R --> G
-    G -->|Trusted hook events| H
-    H --> L["session-ledger · event chronology"]
-    G -->|Check work · /lit-handoff| N["Project working notes and handoff"]
-    N -.->|User supplies the path| G
+```bash
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
 ```
 
-The hooks' `.grok/litgrok/session-ledger/` records event order. Judge success from the artifact and its checks. The user supplies the handoff path in the next session; having a record does not automatically resume work.
-
-[Checklist and hook boundaries](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/litwork/SKILL.md) · [Handoff destinations](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/lit-handoff/SKILL.md) · [Install details](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#install)
+The installer never runs `git init`, grants hook trust, writes login state or API keys, or chooses a model. A passing package test does not prove live Grok behavior; check `/hooks` and `grok inspect --json` from the repository root in your own session.
 
-### Design and README production
+## If something does not work
 
-Use `/frontend-ui-ux <surface and outcome>` to build and inspect an authorized interface. A clear brief proceeds to working code; material ambiguity prompts a focused question. Review-only and plan-only requests remain read-only.
+- **No hooks:** hooks need a trusted Git project root. For a new project, run `git init` yourself before trusting it; for an existing one, open Grok Build from its actual root.
+- **Nothing was written:** one of the preview conditions above applied. Check that the installer reports actual writes.
+- **No status row:** the row comes from user or administrator configuration. Grok does not read it from project or plugin configuration.
 
-Use the `/lit-diagram-drawer` skill for conceptual and technical diagrams. Its exact slash route is a candidate until verified in Grok Build; `/skills` is the discovery surface. Ordinary interfaces stay with `/frontend-ui-ux`, and measured-data plots stay with `/lit-scientific-visualization`.
+---
 
-Use `lit-pptx` for slides and `lit-docx` for reports and Word documents. With bare `lit`, the project rule asks Grok Build to select one or both from the request wording. The deck defaults to AZURE-PRO with Pretendard; a Korean document defaults to korean-generic. The package includes the engines, templates, QA scripts, and pinned first-use cache installers. Slides require Node.js 20.9+; the DOCX workflow and base installer remain separate. Check the skill pages for commands and optional render tools. Skill selection is host guidance until observed in a Grok session.
+**[Full guide, skills gallery and troubleshooting on GitHub →](https://github.com/wjgoarxiv/litgrok#readme)**
 
-Use `/readme-studio <repository and outcome>` for a source-checked README, outlined Pretendard/Meslo typography, and portable cover/motion recipes. Check `/skills` after installation. Native image generation depends on the tools exposed in your Grok session; `IMAGE_GENERATION_UNAVAILABLE` permits an explicitly supplied background path. Fonts and renderers are task-local prerequisites. Local output is separate from live host and GitHub/npm acceptance. [README Studio](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/readme-studio/SKILL.md).
+[Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/CHANGELOG.md) · [Privacy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/privacy.md) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE)
 
 The cover is brand motion made with the LitFamily motion skill, not a recording of a Grok task execution.
-
-## Skills at a glance
-
-All 38 skills, one row each. The route is the one the skill documents; `/skills` shows what your Grok Build session loaded. [Rename compatibility](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#skill-rename-compatibility) covers the one-release aliases; old slash routes are not guaranteed.
-
-<table>
-<tr><th>What it looks like</th><th>Skill</th><th>What you get</th></tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litwork.webp" width="240" alt="A bounded session checklist. LitGrok's hooks log each step to a local ledger." /></td>
-<td><code>litwork</code><br /><sub><code>/litwork &lt;goal&gt;</code></sub></td>
-<td>A bounded session checklist. LitGrok's hooks log each step to a local ledger.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-plan.webp" width="240" alt="A plan file with numbered rows that /start-work can run. Nothing is edited yet." /></td>
-<td><code>lit-plan</code><br /><sub><code>/lit-plan &lt;objective&gt;</code></sub></td>
-<td>A plan file with numbered rows that <code>/start-work</code> can run. Nothing is edited yet.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/start-work.webp" width="240" alt="Runs a plan row by row. A row is checked only after gates A to F pass." /></td>
-<td><code>start-work</code><br /><sub><code>/start-work &lt;plan path&gt;</code></sub></td>
-<td>Runs a plan row by row. A row is checked only after gates A to F pass.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/review-work.webp" width="240" alt="Six read-only review lanes rank what they find by evidence." /></td>
-<td><code>review-work</code><br /><sub><code>/review-work &lt;target&gt;</code></sub></td>
-<td>Six read-only review lanes rank what they find by evidence.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litgoal.webp" width="240" alt="Shapes one checkable goal and hands you a native /goal line to run. LitGrok stores no goal state." /></td>
-<td><code>litgoal</code><br /><sub><code>/litgoal &lt;request&gt;</code></sub></td>
-<td>Shapes one checkable goal and hands you a native <code>/goal</code> line to run. LitGrok stores no goal state.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-recap.webp" width="240" alt="A short account with evidence, rebuilt from Grok Build session history." /></td>
-<td><code>lit-recap</code><br /><sub><code>/lit-recap</code></sub></td>
-<td>A short account with evidence, rebuilt from Grok Build session history.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-handoff.webp" width="240" alt="Type handoff for a resume file the next session can read. Secrets stay out." /></td>
-<td><code>lit-handoff</code><br /><sub><code>handoff</code> · <code>/lit-handoff</code></sub></td>
-<td>Type <code>handoff</code> for a resume file the next session can read. Secrets stay out.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/deep-interview.webp" width="240" alt="One question at a time, in a fixed order, until the request is clear enough to plan." /></td>
-<td><code>deep-interview</code><br /><sub><code>/deep-interview &lt;request&gt;</code></sub></td>
-<td>One question at a time, in a fixed order, until the request is clear enough to plan.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litresearch.webp" width="240" alt="Bounded research with every claim traced to a source and no evidence overstated." /></td>
-<td><code>litresearch</code><br /><sub><code>/litresearch &lt;question&gt;</code></sub></td>
-<td>Bounded research with every claim traced to a source and no evidence overstated.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-crucible.webp" width="240" alt="Pressure-tests a brief before planning. Only the risks that survive critique reach the plan." /></td>
-<td><code>lit-crucible</code><br /><sub><code>/lit-crucible &lt;approach&gt;</code></sub></td>
-<td>Pressure-tests a brief before planning. Only the risks that survive critique reach the plan.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-init.webp" width="240" alt="Finds the project guidance that exists, flags conflicts and gaps, and proposes a layout. Nothing is written until you approve." /></td>
-<td><code>lit-init</code><br /><sub><code>/lit-init &lt;path&gt;</code></sub></td>
-<td>Finds the project guidance that exists, flags conflicts and gaps, and proposes a layout. Nothing is written until you approve.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-comprehend.webp" width="240" alt="An explainer page for agent-written work: intuition first, then the walkthrough, then a short quiz." /></td>
-<td><code>lit-comprehend</code><br /><sub><code>/lit-comprehend &lt;scope&gt;</code></sub></td>
-<td>An explainer page for agent-written work: intuition first, then the walkthrough, then a short quiz.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-humanizer.webp" width="240" alt="Rewrites stiff model prose in English or Korean. Facts and hedges stay; filler goes." /></td>
-<td><code>lit-humanizer</code><br /><sub><code>/lit-humanizer &lt;draft or file&gt;</code></sub></td>
-<td>Rewrites stiff model prose in English or Korean. Facts and hedges stay; filler goes.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-diagram-drawer.webp" width="240" alt="A checked, editable diagram for slides and documents, with PNG and Office-safe SVG exports." /></td>
-<td><code>lit-diagram-drawer</code><br /><sub><code>/lit-diagram-drawer &lt;brief&gt;</code></sub></td>
-<td>A checked, editable diagram for slides and documents, with PNG and Office-safe SVG exports.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-pptx.webp" width="240" alt="An editable PowerPoint deck with its Markdown source, AZURE-PRO and Pretendard by default. A QA gate runs on the file, and slides are inspected when LibreOffice is present." /></td>
-<td><code>lit-pptx</code><br /><sub><code>/lit-pptx &lt;presentation request&gt;</code></sub></td>
-<td>An editable PowerPoint deck with its Markdown source, AZURE-PRO and Pretendard by default. A QA gate runs on the file, and slides are inspected when LibreOffice is present.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-docx.webp" width="240" alt="A styled Word document with its Markdown source; Korean reports use korean-generic. Prose lint and a DOCX audit run, and pages are inspected when LibreOffice is present." /></td>
-<td><code>lit-docx</code><br /><sub><code>/lit-docx &lt;document request&gt;</code></sub></td>
-<td>A styled Word document with its Markdown source; Korean reports use korean-generic. Prose lint and a DOCX audit run, and pages are inspected when LibreOffice is present.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/frontend-ui-ux.webp" width="240" alt="Builds a working interface, then a probe renders it in seven views: four widths, dark, reduced motion and 200% zoom." /></td>
-<td><code>frontend-ui-ux</code><br /><sub><code>/frontend-ui-ux &lt;surface and outcome&gt;</code></sub></td>
-<td>Builds a working interface, then a probe renders it in seven views: four widths, dark, reduced motion and 200% zoom.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/readme-studio.webp" width="240" alt="A factual README with a cover, outlined type and local motion." /></td>
-<td><code>readme-studio</code><br /><sub><code>/readme-studio &lt;repository and outcome&gt;</code></sub></td>
-<td>A factual README with a cover, outlined type and local motion.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-typographic-motion.webp" width="240" alt="A finished short film from a treatment, rendered by LitGrok's own type engine or stage capture and checked by its QA gate." /></td>
-<td><code>lit-typographic-motion</code><br /><sub><code>/lit-typographic-motion &lt;request&gt;</code></sub></td>
-<td>A finished short film from a treatment, rendered by LitGrok's own type engine or stage capture and checked by its QA gate.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-scientific-visualization.webp" width="240" alt="A publication-ready figure and caption from verified data. The chart type follows the data." /></td>
-<td><code>lit-scientific-visualization</code><br /><sub><code>/lit-scientific-visualization</code></sub></td>
-<td>A publication-ready figure and caption from verified data. The chart type follows the data.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-team.webp" width="240" alt="Splits work into bounded task packets for Grok Build's built-in subagents. The parent integrates and verifies." /></td>
-<td><code>lit-team</code><br /><sub><code>/lit-team</code></sub></td>
-<td>Splits work into bounded task packets for Grok Build's built-in subagents. The parent integrates and verifies.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/autoresearch.webp" width="240" alt="A bounded research campaign: subagents, evidence gates, one synthesis." /></td>
-<td><code>autoresearch</code><br /><sub><code>/autoresearch &lt;mode&gt; &lt;objective&gt;</code></sub></td>
-<td>A bounded research campaign: subagents, evidence gates, one synthesis.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/autoconference.webp" width="240" alt="Subagent lanes deliberate on evidence, and the synthesis keeps disagreement." /></td>
-<td><code>autoconference</code><br /><sub><code>/autoconference &lt;mode&gt; &lt;topic&gt;</code></sub></td>
-<td>Subagent lanes deliberate on evidence, and the synthesis keeps disagreement.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/wikify.webp" width="240" alt="A local project knowledge map with sources, kept under .grok/." /></td>
-<td><code>wikify</code><br /><sub><code>/wikify &lt;mode&gt;</code></sub></td>
-<td>A local project knowledge map with sources, kept under <code>.grok/</code>.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/debugging.webp" width="240" alt="Reproduces the bug, tests at least three explanations, and fixes only the confirmed cause." /></td>
-<td><code>debugging</code><br /><sub><code>/debugging &lt;symptom&gt;</code></sub></td>
-<td>Reproduces the bug, tests at least three explanations, and fixes only the confirmed cause.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/refactor.webp" width="240" alt="Restructures code in an isolated worktree while tests pin its behavior." /></td>
-<td><code>refactor</code><br /><sub><code>/refactor &lt;target&gt;</code></sub></td>
-<td>Restructures code in an isolated worktree while tests pin its behavior.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-burnoff.webp" width="240" alt="Cleans AI-written bloat out of a change set after tests lock what it does." /></td>
-<td><code>lit-burnoff</code><br /><sub><code>/lit-burnoff &lt;scope&gt;</code></sub></td>
-<td>Cleans AI-written bloat out of a change set after tests lock what it does.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-burnoff-file.webp" width="240" alt="Cleans generated prose patterns out of one file and checks the diff." /></td>
-<td><code>lit-burnoff-file</code><br /><sub><code>/lit-burnoff-file &lt;path&gt;</code></sub></td>
-<td>Cleans generated prose patterns out of one file and checks the diff.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-code.webp" width="240" alt="Strict implementation rules: tests first, typed boundaries, small files." /></td>
-<td><code>lit-code</code><br /><sub><code>/lit-code &lt;task&gt;</code></sub></td>
-<td>Strict implementation rules: tests first, typed boundaries, small files.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-commit.webp" width="240" alt="Splits your changes into atomic commits in the repo's own style and leaves unrelated work alone." /></td>
-<td><code>lit-commit</code><br /><sub><code>/lit-commit &lt;operation&gt;</code></sub></td>
-<td>Splits your changes into atomic commits in the repo's own style and leaves unrelated work alone.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lsp.webp" width="240" alt="Turns on Grok Build's built-in LSP code-intel tool, which is off by default." /></td>
-<td><code>lsp</code><br /><sub><code>/lsp</code></sub></td>
-<td>Turns on Grok Build's built-in LSP code-intel tool, which is off by default.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lsp-setup.webp" width="240" alt="Checks which language servers Grok Build can see and names the fallback when diagnostics are not exposed." /></td>
-<td><code>lsp-setup</code><br /><sub><code>/lsp-setup &lt;path or extension&gt;</code></sub></td>
-<td>Checks which language servers Grok Build can see and names the fallback when diagnostics are not exposed.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/structural-search.webp" width="240" alt="Traces code structure with search, read and optional LSP references. It does not invent an engine." /></td>
-<td><code>structural-search</code><br /><sub><code>/structural-search &lt;pattern&gt;</code></sub></td>
-<td>Traces code structure with search, read and optional LSP references. It does not invent an engine.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/visual-qa.webp" width="240" alt="A screenshot-backed review of a rendered interface." /></td>
-<td><code>visual-qa</code><br /><sub><code>/visual-qa &lt;target&gt;</code></sub></td>
-<td>A screenshot-backed review of a rendered interface.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/browser-drive.webp" width="240" alt="Drives a real page after verifying the browser driver. If there is none, it says so." /></td>
-<td><code>browser-drive</code><br /><sub><code>/browser-drive &lt;url&gt;</code></sub></td>
-<td>Drives a real page after verifying the browser driver. If there is none, it says so.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/comment-checker.webp" width="240" alt="Reviews the comments an edit added: reasons stay, narration goes." /></td>
-<td><code>comment-checker</code><br /><sub><code>/comment-checker &lt;path&gt;</code></sub></td>
-<td>Reviews the comments an edit added: reasons stay, narration goes.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/rules.webp" width="240" alt="Explains which guidance Grok Build loads for this folder, in what order, and whether hooks are trusted." /></td>
-<td><code>rules</code><br /><sub><code>/rules</code></sub></td>
-<td>Explains which guidance Grok Build loads for this folder, in what order, and whether hooks are trusted.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litgrok.webp" width="240" alt="Explains what the LitGrok package installs, and what it does not." /></td>
-<td><code>litgrok</code><br /><sub><code>/litgrok</code></sub></td>
-<td>Explains what the LitGrok package installs, and what it does not.</td>
-</tr>
-</table>
-
-## Command and hook table
-
-### Prompt or route
-
-Grok Build uses the explicit `/litwork` route for a bounded task. It owns model execution; LitGrok leaves skills, rules, and checked next steps in the project.
-
-| Prompt or route | Effect |
-| --- | --- |
-| `/litwork` | Start the shipped work checklist in Grok Build. |
-| `handoff` or `/lit-handoff` | Carry the checked result and next step into another session. |
-| `/lit-plan` | Write a plan with concrete checks. |
-| `/start-work <approved-plan>` | Execute an approved plan. |
-| `/review-work` | Review a change and its evidence. |
-| `/litresearch` | Run bounded, source-traceable research without overstating evidence. |
-
-### Project hooks
-
-| Surface | Registration and boundary |
-| --- | --- |
-| Project hooks | Eleven registrations are declared in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/hooks/hooks.json). They require a trusted Git root and `/hooks-trust`; a plain folder may load skills and rules without hooks. |
-
-## Troubleshooting
-
-### Project hooks
-
-Project hooks need a trusted Git project root in Grok Build. A plain folder can still load the installed skills and rules while hooks remain unavailable. For a new disposable project, run `git init` yourself before trusting it; for an existing repository, open Grok Build from its actual root. The installer never runs `git init` or changes trust. In the observed Grok Build 1.0.23 host, `grok --trust inspect --json` accepted the trust-and-inspect route even though `--trust` was omitted from `grok --help`; this is version-specific behavior.
-
-### Install preview
-
-If `CI` or `NO_COLOR` is set, even to an empty value, installation is a no-write preview. So is `--no-color`. Without `--yes`, a non-interactive run is also a no-write preview; with `--yes`, installation proceeds without a TTY as long as none of the above apply. Check that the installer reports actual writes before continuing.
-
-**Status row missing:** the persistent row is optional and uses user or administrator configuration; project and plugin configuration are not read for this setting. See the [status-line reference](https://docs.x.ai/build/features/status-line).
-
-For host limits and current verification steps, see the [operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#verify).
-
-## Links
-
-- [Operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md): installation, hooks, terminal output, payload checks, and source provenance.
-- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/rules/00-litgrok.md) and [skill catalog](https://github.com/wjgoarxiv/litgrok/tree/main/.grok/skills).
-- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CHANGELOG.md) and [license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE).
-
-- [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CONTRIBUTING.md), [security](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/SECURITY.md), [conduct](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CODE_OF_CONDUCT.md), and [support](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/SUPPORT.md).
-- [Privacy and local data](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/privacy.md); [migration from the old npm name](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference.md#npm-package-migration).
-
-### LITFAMILY
-
-The motion cover at the top shows five armored robots representing the products. Each works independently in its own host; they do not need to be installed together or connected to one another.

package/README_ko-KR.md

@@ -1,436 +1,102 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitGrok 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
-
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크 — Grok" /></p>
-
-<details>
-<summary>ASCII 로고 복사</summary>
-
-```text
-                             ▄▄▄▄
-                   ▗███▌   ▗██████▖
- ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
- ▐█████        ▗▟██████▌    ▝▀▜█▀▘
- ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
- ▐█████    ▗▟█████████████████████████ ▐█▀
- ▐█████    ████████████████████████████▀
- ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
- ▐█████    ▀    ▄██ ████▌█████████████▌
- ▐█████       ▄████ ████▌█████████████▌
- ▐█████     ▄█████▛
- ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
- ▐█████ ▐█████▀          █████     ▐▛▀
- ▐█████ ▐███▀            █████
- ▐█████ ▐█▀              █████
- ▐█████ ▝                █████
- ▐█████▄▄▄▄▄▄▄▖          █████
- ▐███████████▛           █████
- ▐██████████▀            █████
-
-
-grok
-```
-
-</details>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitGrok 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <h1 align="center">LitGrok</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 
 Grok Build에서 작은 결과물을 만들고, 확인한 내용과 다음 할 일을 프로젝트에 남기세요.
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/README.md) · [설치](#30초-설치) · [빠른 시작](#빠른-시작) · [스킬](#스킬-한눈에-보기) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md)
+**[GitHub에서 전체 안내와 스킬 갤러리 보기](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)** · [English](https://github.com/wjgoarxiv/litgrok#readme) · [설치](#30초-설치) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference_ko-KR.md)
 
 <p align="center">
-<a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/badge-version.svg" alt="1.0.9" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/badge-version.svg" alt="1.0.10" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 </p>
 
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> &nbsp; <a href="#30초-설치">설치</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> &nbsp; <a href="#30초-설치">설치</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
+
+LitGrok은 Grok Build 위에 일하는 방식을 얹습니다. 계획하고, 만들고, 확인하고, 다음 세션이 읽을 인수인계 문서를 남기는 방식입니다. 스킬 38개, 에이전트 11개, 프로젝트 규칙 하나, 훅 등록 열한 개가 들어 있고, 세션 실행과 모델 선택은 계속 Grok Build가 맡습니다.
 
 ## 30초 설치
 
-Node.js와 Grok Build를 준비한 뒤 체험할 프로젝트의 대화형 터미널에서 실행하세요. 기본 설치는 scoped package를 사용합니다.
+Node.js와 Grok Build가 있으면 됩니다. 써 보고 싶은 프로젝트에서 대화형 터미널을 열고 실행하세요.
 
 ```bash
 npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
 ```
 
-별도 체험을 하려면 로컬 패키지의 실제 절대 경로를 변수에 넣고 두 줄을 차례로 실행하세요.
+파일은 `<project>/.grok/`에 들어갑니다. `~/.grok/`에 설치하려면 `--user`를, 이 릴리스로 고정하려면 `--package @litfamily/litgrok@1.0.10`을 쓰세요. `--dry-run`을 붙이면 파일을 쓰기 전에 들어갈 경로를 모두 보여 줍니다.
+
+로컬 패키지로 써 보려면 실제 절대 경로를 변수에 넣고 두 줄을 따로 실행하세요.
 
 ```bash
 LITGROK_PACK='/absolute/path/to/the-provided-package.tgz'
 npm exec --yes --package "$LITGROK_PACK" -- litgrok install
 ```
 
-기본 설치 위치는 `<project>/.grok/`입니다. 버전을 고정하려면 `--package @litfamily/litgrok@1.0.9`를 사용하세요. `--user`를 붙이면 `~/.grok/`에 설치합니다. [설치·업데이트 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#설치).
-
-Grok 상태 행의 지속 표시는 선택 사항이며 사용자 범위에서만 설정할 수 있습니다.
-
-```bash
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok install --user --status-line
-```
-
-이 명령은 2초 간격으로 갱신되는 `[ui.status_line]`을 `~/.grok/config.toml`에 추가합니다. 기존 config를 바꾸기 전에 백업하며, 이미 `ui.status_line` 설정이 있으면 보존합니다. `uninstall --user`는 변경되지 않은 LitGrok 관리 값만 제거합니다. Grok은 이 설정을 사용자 또는 관리자 config에서 읽으며 project/plugin config에서는 읽지 않습니다 ([상태 행 문서](https://docs.x.ai/build/features/status-line), [설정 참조](https://docs.x.ai/build/settings/reference)). 예시는 `🔥 LIT IGNITED · lit-plan 🔥 │ grok-4 │ ctx 42%`와 `LIT · grok │ grok-4 │ ctx 42%`입니다. 본문에서 inline 또는 fenced Markdown code를 제외한 뒤 `lit-scientific-visualization`, `lit-handoff`, `autoconference`, `autoresearch`, `lit-plan`, `litwork` 중 처음 일치한 항목이 규율을 정하고, 단독 `lit`은 `litwork`로 표시합니다. 색상을 사용하면 활성 `LIT IGNITED · <discipline>` label을 굵은 글씨로 문자마다 truecolor gradient(`#FF6337 → #FF2D95 → #00E5FF`)를 적용하고, 불꽃 emoji와 model/context 구간은 색칠하지 않습니다. 빈 값을 포함한 `NO_COLOR` 또는 `LITGROK_HUD_COLOR=0`은 escape 없는 plain 행을 유지합니다. Grok Build 1.0.13 상태 행에서 truecolor, 굵은 글씨, emoji가 표시되는 것을 확인했습니다. 이 기능은 status command를 추가하며 hook 등록 수를 늘리지 않습니다. LitGrok에는 계속 11개 hook 등록이 있습니다.
-
-### 안전과 제거
-
-파일을 쓰기 전에 설치 경로를 확인하세요.
-
-```bash
-npm exec --yes --package "$LITGROK_PACK" -- litgrok install --dry-run
-```
-
-Installer는 업데이트·삭제 전에 파일 소유권을 확인합니다. 사용자가 수정했거나 소유권을 확인할 수 없는 파일, 안전하지 않은 경로가 있으면 작업을 거부합니다. `CI`, `NO_COLOR`(값이 비어 있어도 적용), `--no-color`, `--dry-run`은 `--yes`와 무관하게 항상 파일을 쓰지 않는 미리보기입니다. `--yes` 없이 실행한 비대화형 설치도 미리보기이며, `--yes`를 쓰면 위 조건이 없는 한 TTY 없이도 진행됩니다.
-
-로컬 패키지로 설치했다면 같은 프로젝트에서 같은 패키지로 제거합니다. `--user` 설치만 제거할 때는 제거 명령에도 `--user`를 붙이세요.
-
-```bash
-npm exec --yes --package "$LITGROK_PACK" -- litgrok uninstall
-```
-
-레지스트리 제거 명령:
-
-```bash
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
-npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
-```
-
-사용자 범위 제거는 `~/.grok/config.toml`을 먼저 백업하고, 변경되지 않은 LitGrok 관리 status-line key만 제거합니다. 다른 설정과 사용자가 수정한 status line은 보존합니다. 설치 범위와 같은 옵션으로 제거하세요. 업데이트는 `install`을 다시 실행합니다. Installer는 Git root를 만들거나 hook trust를 허용하거나 로그인 상태·API 키를 쓰거나 모델을 선택하지 않습니다. Hedge guard는 host 오류 시 fail-open으로 동작합니다. 패키지 테스트가 통과해도 live Grok 동작을 확인한 것은 아닙니다. Git root에서 현재 세션의 `/hooks`와 `grok inspect --json`을 확인하세요. [Host 경계와 검증](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#검증).
-
-## 빠른 시작
+## 처음 입력해 볼 것
 
-설치한 프로젝트의 Git root에서 Grok Build를 열거나 재시작합니다. `/hooks-trust`에서 project hook을 확인하고 신뢰하세요. 관찰된 Grok Build 1.0.23에서는 `grok --trust inspect --json`도 사용할 수 있지만 `--help`에는 이 global flag가 나오지 않습니다. 일반 폴더에서는 skill과 rule이 로드되어도 hook은 0개로 남을 수 있습니다. `/skills`에서 설치된 목록을, `/hooks`에서 hook 등록을 확인합니다. LitGrok은 Git root를 만들거나 trust를 바꾸지 않습니다.
-
-외부 서비스나 기존 테스트가 필요 없는 작은 작업부터 시작하세요. Grok Build에 다음을 입력합니다.
+프로젝트의 Git 루트에서 Grok Build를 열거나 다시 시작하고, `/hooks-trust`에서 훅을 살펴본 뒤 신뢰하세요. 관찰된 Grok Build 1.0.23에서는 `grok --trust inspect --json`도 쓸 수 있습니다. 일반 폴더에서도 스킬과 규칙은 불러오지만 훅은 잡히지 않을 수 있습니다. 그다음 이렇게 보내 보세요.
 
 ```text
 /litwork 외부 의존성 없이 index.html 하나로 할 일 목록을 만들어줘. 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 할 일을 남겨줘. 브라우저를 자동으로 열지 말고 내가 확인할 순서를 알려줘.
 ```
 
-생성된 `index.html`을 직접 열어 항목 추가, 완료 표시, 삭제를 확인하세요. 파일이 생겼다는 것과 동작을 확인했다는 것은 다릅니다. 실행하지 못한 검사는 미확인으로 남기고, 오류가 있으면 실제 결과를 세션에 알려주세요.
-
-### 다음 세션으로 불씨 건네기
+만들어진 `index.html`을 직접 열어 항목을 추가하고, 완료로 표시하고, 지워 보세요. 돌려 보지 못한 검사는 미확인으로 남겨 두세요.
 
-```text
-계획하기 → 만들기 → 확인하기 → 다음 작업에 건네기
-```
+## 다음 세션으로 이어 가기
 
-큰 변경이라면 `/lit-plan`으로 계획을 만들고 저장된 계획을 검토한 뒤 `/start-work <plan path>`를 호출하세요. 작업을 멈출 때는 다음처럼 요청할 수 있습니다.
+큰 변경이라면 `/lit-plan`으로 계획을 만들고, 저장된 계획을 읽어 본 뒤 `/start-work <plan path>`를 실행하세요. 멈추기 전에는 이렇게 요청합니다.
 
 ```text
 /lit-handoff 지금까지 만든 것, 확인한 것, 남은 일을 기록하고 저장 경로를 알려줘.
 ```
 
-새 세션에서는 반환된 경로를 직접 지정해 문서를 읽고 현재 파일 상태부터 확인하도록 요청하세요. 기본 경로는 새 Git 프로젝트에서 `.handoff/HANDOFF.md`, Git이 없는 작업 폴더에서 `HANDOFF.md`입니다. 기존 루트 handoff가 있으면 그 파일을 사용합니다. [경로 선택과 인수인계 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/lit-handoff/SKILL.md).
-
-**불씨를 남긴다는 것은 다음에 이어갈 일을 기록한다는 뜻입니다.** Skill이 현재 세션의 작업 절차를 안내합니다. LitGrok이 백그라운드 작업을 예약하거나 세션이 끝난 뒤 작업을 계속하지는 않습니다.
-
-## 주요 기능
-
-> **불씨를 건네받았다. 이제, 당신의 작업에 옮길 차례다.**
->
-> 고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
->
-> 시작은 짧은 한 줄이면 됩니다. 세션이 바뀌면 어려운 건 어디까지 했는지 다시 짚는 일입니다. LIT은 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에 남기는 작업을 안내합니다.
->
-> **대화가 끝난 자리에서, 다음 작업이 시작되도록.**
-
-skill 38개, agent 11개, project rule 하나, hook 등록 열한 개를 제공합니다. Installer가 프로젝트에 전체 파일을 복사하고, 세션 실행과 모델 선택은 Grok Build가 담당합니다.
-
-긴 문서 편집이나 한국어 심층 교정에는 `lit-humanizer`를 사용하세요. PreToolUse guard는 새로 추가한 독자용 문장만 검사하며, 명확한 block 신호가 있으면 저장 전에 고쳐야 합니다. Warning 신호는 참고용입니다. 도구가 만든 DOCX와 PPTX는 생성 직후 검사하고, PDF는 `pdftotext`가 설치되어 있으면 검사합니다. 추출기를 사용할 수 없어도 파일은 그대로 두고 확인 범위를 알립니다.
-
-브라우저 자동화 도구는 `npm run probe:browser-drive`로 확인합니다. LitGrok이 안내하는 CLI는 [agent-browser](https://github.com/vercel-labs/agent-browser)이며, LitGrok이 대신 설치하지는 않습니다. 없다는 결과가 나오면 사용자가 `npm install -g agent-browser`와 `agent-browser install`을 실행하세요.
-
-패키지: `@litfamily/litgrok` · 버전: `1.0.9` · [MIT](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE)
-
-과학 시각화 corpus는 `.grok/vendor/scientific-visualization/`에 포함되며, 숫자 `045_scientific-visualization` 표기는 라이선스와 provenance 파일명에만 남습니다.
-
-이 경로 예시는 정적 안내이며 실제 호스트 동작을 증명하지 않습니다.
+다음 세션에서는 돌려받은 경로를 Grok Build에 알려 주고, 그 문서를 읽은 뒤 현재 파일 상태부터 확인하라고 요청하세요. 인수인계 문서가 있다고 작업이 저절로 이어지지는 않습니다.
 
-다섯 activation 계약은 모델이 활성 응답을 다른 내용보다 먼저 한 줄로 시작하도록 요청합니다. `/litwork`에서 요청하는 줄은 다음과 같습니다.
+## 자주 쓰는 명령
 
-🔥 **LIT IGNITED · litwork** 🔥
-
-이는 advisory prompt 지침이며 native host 표시 여부를 확인하지 않습니다.
-
-유지된 `docs/assets/cover.svg`는 편집 가능한 벡터 원본이며, 이 README는 동작 감소를 선호할 때 모션 커버의 정지 프레임을 표시합니다.
-
-### Grok Build 안에서 연결되는 것들
-
-Installer는 프로젝트의 `.grok/`에 파일을 놓습니다. `/litwork`는 현재 세션에서 따를 작업 절차를 안내하고, 실제 실행과 모델 선택은 Grok Build가 맡습니다. 아래는 주요 연결 관계입니다.
-
-```mermaid
-flowchart TD
-    I["litgrok install"] --> P["프로젝트 .grok/ 파일"]
-    P --> S["skills · /litwork"]
-    P --> R["rules · 프로젝트 지침"]
-    P --> H["hooks · /hooks-trust 필요"]
-    S --> G["Grok Build 세션"]
-    R --> G
-    G -->|신뢰한 hook 이벤트| H
-    H --> L["session-ledger · 이벤트 기록"]
-    G -->|작업 확인 · /lit-handoff| N["프로젝트 작업 노트와 handoff"]
-    N -.->|사용자가 경로를 전달| G
-```
-
-Hook의 `.grok/litgrok/session-ledger/`는 이벤트가 발생한 순서를 남깁니다. 작업 성공 여부는 결과물과 확인 기록으로 판단하세요. 다음 세션에서는 사용자가 handoff 경로를 전달합니다. 기록이 있다고 작업이 자동으로 재개되지는 않습니다.
-
-[작업 절차와 hook의 범위](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/litwork/SKILL.md) · [인수인계 경로](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/skills/lit-handoff/SKILL.md) · [설치 상세](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#설치)
-
-### 화면과 README 제작
-
-`/frontend-ui-ux <화면과 목표>`는 요청 범위의 화면을 구현하고 렌더링을 확인합니다. 충분한 요구사항이면 바로 제작하고, 중요한 방향이 불명확할 때만 질문합니다. 검토·계획 전용 요청에서는 파일을 수정하지 않습니다.
-
-개념·기술 다이어그램에는 `/lit-diagram-drawer` skill을 사용합니다. 정확한 slash 경로는 Grok Build에서 확인하기 전까지 후보이며, `/skills`에서 skill을 찾을 수 있습니다. 일반 화면은 `/frontend-ui-ux`, 측정 데이터 그래프는 `/lit-scientific-visualization` 범위입니다.
-
-슬라이드 런타임에는 Node.js 20.9 이상이 필요합니다. DOCX와 기본 설치 기능은 별도로 동작합니다.
-발표자료는 `lit-pptx`, 보고서와 워드 문서는 `lit-docx`를 사용합니다. 맨 끝의 `lit` 요청은 project rule이 문서·발표 표현을 보고 하나 또는 둘 다 고르도록 안내합니다. 슬라이드 기본값은 AZURE-PRO와 Pretendard, 한국어 문서 기본값은 korean-generic입니다. 엔진, 템플릿, 품질 검사와 첫 사용 시 고정된 의존성을 캐시에 설치하는 도구가 포함됩니다. 정확한 명령과 선택적 렌더 도구는 각 skill 문서를 보세요. 실제 Grok 세션 전에는 선택 여부가 확인되지 않습니다.
-
-`/readme-studio <저장소와 목표>`는 저장소 사실에 근거한 README, Pretendard/Meslo 윤곽선 글자와 커버·모션 소스를 만듭니다. 설치 후 `/skills`에서 확인하세요. 이미지 도구가 없으면 `IMAGE_GENERATION_UNAVAILABLE`을 알리고 명시적으로 제공된 배경으로 제작할 수 있습니다. 폰트와 렌더러는 작업 폴더에서 준비합니다. 로컬 결과는 실제 호스트 동작 및 GitHub/npm 게시 후 검증과 구분합니다.
-
-커버의 모션은 LitFamily 모션 skill로 만든 브랜드 연출이며, 실제 Grok 작업 실행을 녹화한 영상이 아닙니다.
-
-## 스킬 한눈에 보기
-
-skill 38개를 한 줄씩 정리했습니다. 경로는 각 skill 문서에 적힌 것이고, 현재 Grok Build 세션에 로드된 목록은 `/skills`에서 확인하세요. 이전 이름을 한 릴리스 동안 별칭으로 유지하는 정책은 [이름 변경과 호환성](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#skill-이름-변경과-호환성)을 보세요. 이전 slash 경로는 보장되지 않습니다.
-
-<table>
-<tr><th>이렇게 됩니다</th><th>스킬</th><th>얻는 것</th></tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litwork.webp" width="240" alt="작업을 범위가 정해진 체크리스트로 바꿉니다. LitGrok 훅이 단계마다 로컬 기록을 남깁니다." /></td>
-<td><code>litwork</code><br /><sub><code>/litwork &lt;goal&gt;</code></sub></td>
-<td>작업을 범위가 정해진 체크리스트로 바꿉니다. LitGrok 훅이 단계마다 로컬 기록을 남깁니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-plan.webp" width="240" alt="/start-work가 실행할 번호 붙은 작업 목록을 파일로 만듭니다. 코드는 아직 건드리지 않습니다." /></td>
-<td><code>lit-plan</code><br /><sub><code>/lit-plan &lt;objective&gt;</code></sub></td>
-<td><code>/start-work</code>가 실행할 번호 붙은 작업 목록을 파일로 만듭니다. 코드는 아직 건드리지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/start-work.webp" width="240" alt="계획을 한 줄씩 실행합니다. A부터 F까지 관문을 모두 통과해야 체크됩니다." /></td>
-<td><code>start-work</code><br /><sub><code>/start-work &lt;plan path&gt;</code></sub></td>
-<td>계획을 한 줄씩 실행합니다. A부터 F까지 관문을 모두 통과해야 체크됩니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/review-work.webp" width="240" alt="읽기 전용 리뷰 여섯 갈래가 찾은 문제를 증거 순으로 정리합니다." /></td>
-<td><code>review-work</code><br /><sub><code>/review-work &lt;target&gt;</code></sub></td>
-<td>읽기 전용 리뷰 여섯 갈래가 찾은 문제를 증거 순으로 정리합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litgoal.webp" width="240" alt="확인 가능한 목표 하나를 다듬어, 직접 실행할 /goal 한 줄을 건넵니다. LitGrok은 목표 상태를 저장하지 않습니다." /></td>
-<td><code>litgoal</code><br /><sub><code>/litgoal &lt;request&gt;</code></sub></td>
-<td>확인 가능한 목표 하나를 다듬어, 직접 실행할 <code>/goal</code> 한 줄을 건넵니다. LitGrok은 목표 상태를 저장하지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-recap.webp" width="240" alt="Grok Build 세션 기록을 바탕으로 증거가 붙은 짧은 요약을 만듭니다." /></td>
-<td><code>lit-recap</code><br /><sub><code>/lit-recap</code></sub></td>
-<td>Grok Build 세션 기록을 바탕으로 증거가 붙은 짧은 요약을 만듭니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-handoff.webp" width="240" alt="handoff라고 치면 다음 세션이 읽을 인수인계 파일을 만듭니다. 비밀 값은 넣지 않습니다." /></td>
-<td><code>lit-handoff</code><br /><sub><code>handoff</code> · <code>/lit-handoff</code></sub></td>
-<td><code>handoff</code>라고 치면 다음 세션이 읽을 인수인계 파일을 만듭니다. 비밀 값은 넣지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/deep-interview.webp" width="240" alt="정해진 순서로 한 번에 한 질문씩 물어, 계획을 세울 수 있을 만큼 요청을 분명히 합니다." /></td>
-<td><code>deep-interview</code><br /><sub><code>/deep-interview &lt;request&gt;</code></sub></td>
-<td>정해진 순서로 한 번에 한 질문씩 물어, 계획을 세울 수 있을 만큼 요청을 분명히 합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litresearch.webp" width="240" alt="범위를 정한 조사입니다. 모든 주장에 출처를 붙이고, 증거보다 크게 말하지 않습니다." /></td>
-<td><code>litresearch</code><br /><sub><code>/litresearch &lt;question&gt;</code></sub></td>
-<td>범위를 정한 조사입니다. 모든 주장에 출처를 붙이고, 증거보다 크게 말하지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-crucible.webp" width="240" alt="계획 전에 요구사항을 반박해 봅니다. 반박을 견딘 위험만 계획으로 넘어갑니다." /></td>
-<td><code>lit-crucible</code><br /><sub><code>/lit-crucible &lt;approach&gt;</code></sub></td>
-<td>계획 전에 요구사항을 반박해 봅니다. 반박을 견딘 위험만 계획으로 넘어갑니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-init.webp" width="240" alt="있는 안내 문서를 찾아 충돌과 빈 곳을 알려주고 배치를 제안합니다. 승인 전에는 아무것도 쓰지 않습니다." /></td>
-<td><code>lit-init</code><br /><sub><code>/lit-init &lt;path&gt;</code></sub></td>
-<td>있는 안내 문서를 찾아 충돌과 빈 곳을 알려주고 배치를 제안합니다. 승인 전에는 아무것도 쓰지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-comprehend.webp" width="240" alt="에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지입니다. 직관, 흐름 설명, 짧은 퀴즈 순서입니다." /></td>
-<td><code>lit-comprehend</code><br /><sub><code>/lit-comprehend &lt;scope&gt;</code></sub></td>
-<td>에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지입니다. 직관, 흐름 설명, 짧은 퀴즈 순서입니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-humanizer.webp" width="240" alt="딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남기고 군더더기는 뺍니다." /></td>
-<td><code>lit-humanizer</code><br /><sub><code>/lit-humanizer &lt;draft or file&gt;</code></sub></td>
-<td>딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남기고 군더더기는 뺍니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-diagram-drawer.webp" width="240" alt="슬라이드와 문서에 넣을 다이어그램을 편집 가능한 형태로 그리고, 검사한 뒤 PNG와 SVG로 내보냅니다." /></td>
-<td><code>lit-diagram-drawer</code><br /><sub><code>/lit-diagram-drawer &lt;brief&gt;</code></sub></td>
-<td>슬라이드와 문서에 넣을 다이어그램을 편집 가능한 형태로 그리고, 검사한 뒤 PNG와 SVG로 내보냅니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-pptx.webp" width="240" alt="편집 가능한 PowerPoint 발표자료와 원고 Markdown을 만듭니다. 기본은 AZURE-PRO와 Pretendard이고, 파일에 품질 검사를 돌리며 LibreOffice가 있으면 슬라이드도 확인합니다." /></td>
-<td><code>lit-pptx</code><br /><sub><code>/lit-pptx &lt;presentation request&gt;</code></sub></td>
-<td>편집 가능한 PowerPoint 발표자료와 원고 Markdown을 만듭니다. 기본은 AZURE-PRO와 Pretendard이고, 파일에 품질 검사를 돌리며 LibreOffice가 있으면 슬라이드도 확인합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-docx.webp" width="240" alt="서식을 갖춘 Word 문서와 원고 Markdown을 만듭니다. 한국어 보고서는 korean-generic 서식을 쓰고, 문체 검사와 DOCX 점검을 돌리며 LibreOffice가 있으면 페이지도 확인합니다." /></td>
-<td><code>lit-docx</code><br /><sub><code>/lit-docx &lt;document request&gt;</code></sub></td>
-<td>서식을 갖춘 Word 문서와 원고 Markdown을 만듭니다. 한국어 보고서는 korean-generic 서식을 쓰고, 문체 검사와 DOCX 점검을 돌리며 LibreOffice가 있으면 페이지도 확인합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/frontend-ui-ux.webp" width="240" alt="실제로 동작하는 화면을 만들고, 프로브로 일곱 가지 보기를 렌더링합니다. 네 가지 폭, 다크 모드, 모션 줄이기, 200% 확대입니다." /></td>
-<td><code>frontend-ui-ux</code><br /><sub><code>/frontend-ui-ux &lt;surface and outcome&gt;</code></sub></td>
-<td>실제로 동작하는 화면을 만들고, 프로브로 일곱 가지 보기를 렌더링합니다. 네 가지 폭, 다크 모드, 모션 줄이기, 200% 확대입니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/readme-studio.webp" width="240" alt="사실에 맞는 README와 커버, 윤곽선 글자, 로컬 모션을 만듭니다." /></td>
-<td><code>readme-studio</code><br /><sub><code>/readme-studio &lt;repository and outcome&gt;</code></sub></td>
-<td>사실에 맞는 README와 커버, 윤곽선 글자, 로컬 모션을 만듭니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-typographic-motion.webp" width="240" alt="트리트먼트로 짧은 영상을 완성합니다. LitGrok의 타입 엔진이나 무대 캡처로 렌더링하고, 품질 검사를 거칩니다." /></td>
-<td><code>lit-typographic-motion</code><br /><sub><code>/lit-typographic-motion &lt;request&gt;</code></sub></td>
-<td>트리트먼트로 짧은 영상을 완성합니다. LitGrok의 타입 엔진이나 무대 캡처로 렌더링하고, 품질 검사를 거칩니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-scientific-visualization.webp" width="240" alt="검증된 데이터로 논문용 그림과 캡션을 만듭니다. 그래프 종류는 데이터 성격에 맞춰 고릅니다." /></td>
-<td><code>lit-scientific-visualization</code><br /><sub><code>/lit-scientific-visualization</code></sub></td>
-<td>검증된 데이터로 논문용 그림과 캡션을 만듭니다. 그래프 종류는 데이터 성격에 맞춰 고릅니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-team.webp" width="240" alt="작업을 범위가 정해진 묶음으로 나눠 Grok Build 기본 서브에이전트에 맡깁니다. 통합과 검증은 부모가 맡습니다." /></td>
-<td><code>lit-team</code><br /><sub><code>/lit-team</code></sub></td>
-<td>작업을 범위가 정해진 묶음으로 나눠 Grok Build 기본 서브에이전트에 맡깁니다. 통합과 검증은 부모가 맡습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/autoresearch.webp" width="240" alt="범위를 정한 연구 작업입니다. 서브에이전트가 조사하고, 증거 관문을 거쳐, 하나로 종합합니다." /></td>
-<td><code>autoresearch</code><br /><sub><code>/autoresearch &lt;mode&gt; &lt;objective&gt;</code></sub></td>
-<td>범위를 정한 연구 작업입니다. 서브에이전트가 조사하고, 증거 관문을 거쳐, 하나로 종합합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/autoconference.webp" width="240" alt="서브에이전트들이 증거를 두고 논의하고, 종합에는 반대 의견도 남깁니다." /></td>
-<td><code>autoconference</code><br /><sub><code>/autoconference &lt;mode&gt; &lt;topic&gt;</code></sub></td>
-<td>서브에이전트들이 증거를 두고 논의하고, 종합에는 반대 의견도 남깁니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/wikify.webp" width="240" alt="출처가 붙은 프로젝트 지식 지도를 .grok/ 아래에 둡니다." /></td>
-<td><code>wikify</code><br /><sub><code>/wikify &lt;mode&gt;</code></sub></td>
-<td>출처가 붙은 프로젝트 지식 지도를 <code>.grok/</code> 아래에 둡니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/debugging.webp" width="240" alt="버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다." /></td>
-<td><code>debugging</code><br /><sub><code>/debugging &lt;symptom&gt;</code></sub></td>
-<td>버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/refactor.webp" width="240" alt="분리된 작업 트리에서 코드 구조를 바꿉니다. 동작은 테스트로 고정합니다." /></td>
-<td><code>refactor</code><br /><sub><code>/refactor &lt;target&gt;</code></sub></td>
-<td>분리된 작업 트리에서 코드 구조를 바꿉니다. 동작은 테스트로 고정합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-burnoff.webp" width="240" alt="테스트로 동작을 먼저 묶어 두고, 변경분에 붙은 AI식 군더더기를 걷어냅니다." /></td>
-<td><code>lit-burnoff</code><br /><sub><code>/lit-burnoff &lt;scope&gt;</code></sub></td>
-<td>테스트로 동작을 먼저 묶어 두고, 변경분에 붙은 AI식 군더더기를 걷어냅니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-burnoff-file.webp" width="240" alt="파일 하나에서 생성된 문장 습관을 걷어내고 변경분을 확인합니다." /></td>
-<td><code>lit-burnoff-file</code><br /><sub><code>/lit-burnoff-file &lt;path&gt;</code></sub></td>
-<td>파일 하나에서 생성된 문장 습관을 걷어내고 변경분을 확인합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-code.webp" width="240" alt="엄격한 구현 규칙입니다. 테스트 먼저, 경계에서 타입 확인, 작은 파일." /></td>
-<td><code>lit-code</code><br /><sub><code>/lit-code &lt;task&gt;</code></sub></td>
-<td>엄격한 구현 규칙입니다. 테스트 먼저, 경계에서 타입 확인, 작은 파일.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lit-commit.webp" width="240" alt="변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다. 관계없는 작업은 건드리지 않습니다." /></td>
-<td><code>lit-commit</code><br /><sub><code>/lit-commit &lt;operation&gt;</code></sub></td>
-<td>변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다. 관계없는 작업은 건드리지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lsp.webp" width="240" alt="기본으로 꺼져 있는 Grok Build 내장 LSP 코드 분석 도구를 켜고 씁니다." /></td>
-<td><code>lsp</code><br /><sub><code>/lsp</code></sub></td>
-<td>기본으로 꺼져 있는 Grok Build 내장 LSP 코드 분석 도구를 켜고 씁니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/lsp-setup.webp" width="240" alt="Grok Build가 볼 수 있는 언어 서버를 확인하고, 진단이 안 보일 때 대안을 알려줍니다." /></td>
-<td><code>lsp-setup</code><br /><sub><code>/lsp-setup &lt;path or extension&gt;</code></sub></td>
-<td>Grok Build가 볼 수 있는 언어 서버를 확인하고, 진단이 안 보일 때 대안을 알려줍니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/structural-search.webp" width="240" alt="검색, 읽기, 선택적 LSP 참조로 코드 구조를 추적합니다. 없는 엔진을 지어내지 않습니다." /></td>
-<td><code>structural-search</code><br /><sub><code>/structural-search &lt;pattern&gt;</code></sub></td>
-<td>검색, 읽기, 선택적 LSP 참조로 코드 구조를 추적합니다. 없는 엔진을 지어내지 않습니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/visual-qa.webp" width="240" alt="렌더링된 화면을 스크린샷 근거로 검토합니다." /></td>
-<td><code>visual-qa</code><br /><sub><code>/visual-qa &lt;target&gt;</code></sub></td>
-<td>렌더링된 화면을 스크린샷 근거로 검토합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/browser-drive.webp" width="240" alt="브라우저 드라이버를 먼저 확인한 뒤 실제 페이지를 조작합니다. 드라이버가 없으면 그렇다고 말합니다." /></td>
-<td><code>browser-drive</code><br /><sub><code>/browser-drive &lt;url&gt;</code></sub></td>
-<td>브라우저 드라이버를 먼저 확인한 뒤 실제 페이지를 조작합니다. 드라이버가 없으면 그렇다고 말합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/comment-checker.webp" width="240" alt="수정으로 추가된 주석을 검토합니다. 이유를 설명하는 주석은 남기고, 코드를 되풀이하는 주석은 뺍니다." /></td>
-<td><code>comment-checker</code><br /><sub><code>/comment-checker &lt;path&gt;</code></sub></td>
-<td>수정으로 추가된 주석을 검토합니다. 이유를 설명하는 주석은 남기고, 코드를 되풀이하는 주석은 뺍니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/rules.webp" width="240" alt="이 폴더에서 Grok Build가 어떤 안내를 어떤 순서로 읽는지, 훅을 신뢰하는지 설명합니다." /></td>
-<td><code>rules</code><br /><sub><code>/rules</code></sub></td>
-<td>이 폴더에서 Grok Build가 어떤 안내를 어떤 순서로 읽는지, 훅을 신뢰하는지 설명합니다.</td>
-</tr>
-<tr>
-<td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/assets/skills/litgrok.webp" width="240" alt="LitGrok 패키지가 무엇을 설치하고 무엇을 설치하지 않는지 설명합니다." /></td>
-<td><code>litgrok</code><br /><sub><code>/litgrok</code></sub></td>
-<td>LitGrok 패키지가 무엇을 설치하고 무엇을 설치하지 않는지 설명합니다.</td>
-</tr>
-</table>
-
-## 명령과 hook 표
-
-### 프롬프트와 경로
-
-Grok Build에서는 명시적인 `/litwork` 경로로 작은 작업을 시작합니다. 모델 실행은 호스트가 담당하고 LitGrok은 프로젝트에 skill, rule, 확인한 다음 단계를 남깁니다.
-
-| 프롬프트 또는 경로 | 효과 |
+| 이렇게 입력하면 | 일어나는 일 |
 | --- | --- |
-| `/litwork` | Grok Build의 제공된 작업 체크리스트를 시작합니다. |
+| `/litwork` | 범위가 정해진 작업에 쓸 체크리스트를 시작합니다. |
 | `handoff` 또는 `/lit-handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 건넵니다. |
-| `/lit-plan` | 확인 기준이 있는 계획을 작성합니다. |
+| `/lit-plan` | 확인 기준이 붙은 계획을 씁니다. |
 | `/start-work <승인된 계획>` | 승인한 계획을 실행합니다. |
-| `/review-work` | 변경과 근거를 검토합니다. |
-| `/litresearch` | 출처를 추적할 수 있는 범위 있는 조사를 하고 근거를 과장하지 않습니다. |
+| `/review-work` | 변경 사항과 그 근거를 검토합니다. |
+| `/litresearch` | 출처를 따라갈 수 있는 범위 안에서 조사하고, 근거보다 크게 말하지 않습니다. |
 
-### Project hook
+세션이 불러온 전체 목록은 `/skills`에서 보입니다. [GitHub의 스킬 갤러리](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md#스킬-한눈에-보기)에서는 38개 스킬을 결과 그림과 함께 볼 수 있습니다.
 
-| 표면 | 등록과 경계 |
-| --- | --- |
-| Project hook | [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/hooks/hooks.json)에 열한 개 등록이 있습니다. 신뢰한 Git root와 `/hooks-trust`가 필요하며, 일반 폴더에서는 skill과 rule만 로드되고 hook은 없을 수 있습니다. |
+코드 밖의 일도 있습니다. `lit-pptx`는 발표자료를, `lit-docx`는 보고서와 Word 문서를 만들고, `/frontend-ui-ux`는 화면을 만들어 확인하며, `/readme-studio`는 저장소 사실에 근거한 README를 씁니다. `lit-humanizer`는 딱딱한 한국어나 영어 문장을 다시 씁니다.
+
+## 설치하면 달라지는 것
 
-## 문제 해결
+설치 프로그램이 스킬, 에이전트, 프로젝트 규칙, 훅을 `.grok/`에 복사합니다. [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/hooks/hooks.json)에 있는 훅 등록 열한 개는 신뢰한 Git 루트에서만 동작하고, `.grok/litgrok/session-ledger/`에 이벤트 순서를 남깁니다. LitGrok이 백그라운드 작업을 예약하거나 세션이 끝난 뒤에 일을 이어 가지는 않습니다.
 
-### Project hook
+원하면 `install --user --status-line`으로 사용자 범위에 상태 행을 켤 수 있습니다. `~/.grok/config.toml`에 `[ui.status_line]`을 추가하며, 파일이 이미 있으면 먼저 백업합니다.
 
-Project hook은 Grok Build에서 신뢰한 Git 프로젝트 루트가 있어야 발견됩니다. 일반 폴더에서도 설치된 skill과 rule은 로드될 수 있지만 hook은 0개로 남을 수 있습니다. 새 disposable project라면 사용자가 직접 `git init`을 실행한 뒤 trust를 허용하세요. 기존 저장소라면 실제 root에서 Grok Build를 여세요. Installer는 `git init`을 실행하거나 trust를 바꾸지 않습니다. 관찰된 Grok Build 1.0.23에서는 `grok --trust inspect --json`이 동작했지만 `grok --help`에는 global `--trust`가 표시되지 않았습니다. 이는 이 버전에서 확인한 동작입니다.
+## 안전과 제거
 
-### 설치 미리보기
+설치 프로그램은 파일을 업데이트하거나 지우기 전에 자기가 설치한 파일인지 확인하고, 사용자가 고친 파일이나 다른 곳에서 온 파일, 안전하지 않은 경로는 덮어쓰지 않습니다. `CI`, `NO_COLOR`(값이 비어 있어도), `--no-color`, `--dry-run`은 `--yes`를 붙여도 파일을 쓰지 않는 미리보기입니다. `--yes` 없이 비대화형으로 실행해도 미리보기로 끝납니다.
 
-`CI`나 `NO_COLOR`가 설정되어 있으면 값이 비어 있어도 설치는 파일을 쓰지 않는 미리보기로 끝납니다. `--no-color`도 같습니다. `--yes` 없이 실행한 비대화형 설치도 미리보기이며, `--yes`를 쓰면 위 조건이 없는 한 TTY 없이도 설치가 진행됩니다. 설치 메시지에서 파일이 쓰였는지 확인한 뒤 다음 단계로 넘어가세요.
+설치할 때와 같은 범위로 제거하세요.
+
+```bash
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
+```
 
-**상태 행이 보이지 않을 때:** 지속 상태 행은 선택 기능이며 사용자 또는 관리자 설정을 사용합니다. project/plugin 설정에서는 이 값을 읽지 않습니다. [상태 행 안내](https://docs.x.ai/build/features/status-line)를 확인하세요.
+설치 프로그램은 `git init`을 실행하거나 훅을 대신 신뢰하지 않고, 로그인 상태나 API 키를 쓰지 않으며, 모델도 고르지 않습니다. 패키지 테스트가 통과했다고 실제 Grok에서도 그렇게 동작한다는 뜻은 아닙니다. 저장소 루트에서 직접 연 세션으로 `/hooks`와 `grok inspect --json`을 확인하세요.
 
-호스트 한계와 확인 절차는 [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#검증)를 참고하세요.
+## 잘 안 될 때
 
-## 링크
+- **훅이 보이지 않을 때:** 훅은 신뢰한 Git 프로젝트 루트가 있어야 잡힙니다. 새 프로젝트라면 신뢰하기 전에 직접 `git init`을 실행하고, 기존 저장소라면 실제 루트에서 Grok Build를 여세요.
+- **파일이 쓰이지 않았을 때:** 위의 미리보기 조건 가운데 하나에 걸린 것입니다. 설치 메시지에서 파일이 실제로 쓰였는지 확인하세요.
+- **상태 행이 보이지 않을 때:** 상태 행은 사용자나 관리자 설정에서 옵니다. Grok은 프로젝트나 플러그인 설정에서는 이 값을 읽지 않습니다.
 
-- [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md): 설치, hook, 터미널 출력, 패키지 검증, 출처.
-- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/.grok/rules/00-litgrok.md)과 [skill 목록](https://github.com/wjgoarxiv/litgrok/tree/main/.grok/skills).
-- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CHANGELOG.md)과 [라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/LICENSE).
+---
 
-- [기여 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CONTRIBUTING.md), [보안](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/SECURITY.md), [행동 규범](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/CODE_OF_CONDUCT.md), [지원](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/SUPPORT.md).
-- [개인정보와 로컬 데이터](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/privacy.md), [기존 npm 이름에서 이전](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.9/docs/reference_ko-KR.md#npm-package-migration).
+**[GitHub에서 전체 안내, 스킬 갤러리, 문제 해결 보기 →](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)**
 
-### LITFAMILY
+[상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference_ko-KR.md) · [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/CHANGELOG.md) · [개인정보](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/privacy.md) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE)
 
-상단 모션 커버에는 다섯 제품을 나타내는 장갑 로봇이 있습니다. 각 제품은 자기 호스트에서 독립적으로 동작하며 함께 설치하거나 서로 연결할 필요가 없습니다.
+커버의 모션은 LitFamily 모션 스킬로 만든 브랜드 연출이며, 실제 Grok 작업 실행을 녹화한 영상이 아닙니다.

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.9"><title>local: 1.0.9</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="290" transform="scale(.1)">local</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.9</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.10"><title>local: 1.0.10</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="290" transform="scale(.1)">local</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.10</text></g></svg>

package/docs/reference.md

@@ -77,7 +77,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
 Pin a version when you need a reproducible install:
 
 ```bash
-npm exec --yes --package @litfamily/litgrok@1.0.9 -- litgrok install
+npm exec --yes --package @litfamily/litgrok@1.0.10 -- litgrok install
 ```
 
 Preview without writing files:

package/docs/reference_ko-KR.md

@@ -77,7 +77,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
 재현 가능한 설치는 버전을 고정합니다.
 
 ```bash
-npm exec --yes --package @litfamily/litgrok@1.0.9 -- litgrok install
+npm exec --yes --package @litfamily/litgrok@1.0.10 -- litgrok install
 ```
 
 파일을 쓰지 않고 미리보기:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litgrok",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Grok Build skills, project rules, and hooks installer.",
   "type": "module",
   "bin": {
@@ -9,9 +9,12 @@
   },
   "scripts": {
     "prepublishOnly": "node scripts/prepublish-test-gate.mjs",
+    "prepack": "node scripts/readme-for-npm.mjs apply",
+    "postpack": "node scripts/readme-for-npm.mjs restore",
     "test": "node --test test/*.test.mjs",
     "probe:browser-drive": "node .grok/skills/browser-drive/scripts/capability-probe.mjs",
-    "check:version": "node tools/check-version-lockstep.mjs"
+    "check:version": "node tools/check-version-lockstep.mjs",
+    "check:npm-readme": "node scripts/readme-for-npm.mjs check"
   },
   "files": [
     "plugin.json",
@@ -48,7 +51,9 @@
     "SECURITY.md",
     "CODE_OF_CONDUCT.md",
     "SUPPORT.md",
-    "docs/privacy.md"
+    "docs/privacy.md",
+    "!**/__pycache__/**",
+    "!**/*.pyc"
   ],
   "publishConfig": {
     "access": "public"

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "litgrok",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Grok Build skills, project rules, and bounded lifecycle hooks for evidence-first lit work.",
   "author": {
     "name": "LitGrok contributors"