القائمة
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.