메뉴
Diagnose and fix Gridix build, launch, and test failures. Use when builds fail, the app won't start, tests break, or dependencies are missing.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Review code changes for correctness, style, and architectural consistency. Use before committing or when asked to review a PR.
Add, modify, or verify Gridix keyboard shortcuts. Use when asked to change a shortcut, fix key routing, add a keybinding, or understand the keyboard system.
Run the full pre-PR checklist. Use when asked to prepare a PR, check code before pushing, run pre-merge checks, or verify changes pass CI.
Execute the Gridix release checklist from bump to publish. Use when asked to release, bump version, publish a release, or tag a version.
Build, run, and drive the Gridix desktop database management app. Use when asked to start, run, launch, build, screenshot, or interact with Gridix.
| name | troubleshoot |
| description | Diagnose and fix Gridix build, launch, and test failures. Use when builds fail, the app won't start, tests break, or dependencies are missing. |
| paths | ["Cargo.toml","Cargo.lock"] |
pkg-config: can't find gtk+-3.0
→ sudo apt-get install -y libgtk-3-dev (Ubuntu) / sudo pacman -S gtk3 (Arch) / sudo dnf install gtk3-devel (Fedora)
pkg-config: can't find xdo
→ sudo apt-get install -y libxdo-dev (Ubuntu) / sudo pacman -S xdotool (Arch)
→ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && source "$HOME/.cargo/env"
→ Use driver: source .claude/skills/run-gridix/driver.sh && launch
Or manually: Xvfb :99 -screen 0 1920x1080x24 &; export DISPLAY=:99; cargo run --release
→ rm -f /tmp/.X99-lock /tmp/.X11-unix/X99 && pkill Xvfb
→ export WINIT_UNIX_BACKEND=x11 before launching
→ sudo apt-get install -y libgtk-3-0 xdotool imagemagick (Ubuntu)
MySQL integration tests are #[ignore]d. Need env vars:
GRIDIX_IT_MYSQL_HOST=127.0.0.1 GRIDIX_IT_MYSQL_PORT=3306 \
GRIDIX_IT_MYSQL_USER=root GRIDIX_IT_MYSQL_PASSWORD=secret \
GRIDIX_IT_MYSQL_DB=test \
cargo test --test mysql_cancel_integration -- --ignored --nocapture
Check: did you change a key another test expects? Is the scope path correct? Is TextEntryGuard blocking the new shortcut?
→ sudo apt-get install -y imagemagick (screenshots) / sudo pacman -S imagemagick
Backup then remove:
cp -r ~/.config/gridix ~/.config/gridix.bak
rm ~/.config/gridix/config.toml ~/.config/gridix/keymap.toml
Relaunch → fresh config created.
The keybindings field in config.toml is legacy read-only. Active keymap: ~/.config/gridix/keymap.toml. See /keybindings skill.
Check service installed + running. Ports: 5432 (PG), 3306 (MySQL). Use welcome page "Recheck" button or Ctrl+N to create connection manually.