[Issue #1341] add pixels-install skill for guided pixels deployments#1342
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new “skills” subsystem to the Pixels repo and introduces the pixels-install skill to guide users through a basic Pixels (and optional Trino) deployment workflow, with shared runtime scripts usable from both Codex and Claude entrypoints.
Changes:
- Introduces
skills/install.sh,skills/uninstall.sh, andskills/list.shplusskills/README.mdto support installing/removing skills for Codex/Claude with project/global scope. - Adds the
pixels-installskill (metadata + Codex/Claude entrypoints + a suite of helper scripts) to drive a guided install aligned todocs/INSTALL.md. - Updates repo guidance and hygiene (
AGENTS.md,.gitignore) to reference the new skill and ignore generated AI tool state.
Reviewed changes
Copilot reviewed 26 out of 27 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/uninstall.sh | New CLI to remove installed skills for Codex/Claude in project/global scope. |
| skills/README.md | Documentation for the skills development directory, layout, and install behavior. |
| skills/pixels-install/skill.yaml | Declares pixels-install metadata, entrypoints, scripts map, and phase list. |
| skills/pixels-install/scripts/progress.sh | Phase checkpoint CLI for resuming multi-step installs. |
| skills/pixels-install/scripts/prepare_trino_cluster.sh | Collects and writes Trino cluster topology + optional SSH bootstrap. |
| skills/pixels-install/scripts/prepare_deployment.sh | Collects and writes Pixels deployment topology + optional SSH bootstrap. |
| skills/pixels-install/scripts/lib/shell_env.sh | Shared env persistence, toolchain chaining, structured results, and phase tracking helpers. |
| skills/pixels-install/scripts/install_trino.sh | Installs/configures Trino and the Pixels Trino connector/listener on a single node. |
| skills/pixels-install/scripts/install_trino_shell_helpers.sh | Optional cluster start/stop helper-function installer (local or coordinator via SSH). |
| skills/pixels-install/scripts/install_trino_cluster.sh | Fans out Trino install across a recorded cluster in parallel over SSH. |
| skills/pixels-install/scripts/install_shell_helpers.sh | Optional Pixels start/stop helper-function installer (local or coordinator via SSH). |
| skills/pixels-install/scripts/install_mysql.sh | Installs/configures MySQL and writes metadata DB credentials for later steps. |
| skills/pixels-install/scripts/install_maven.sh | Installs/verifies Maven (with reuse-if-satisfied behavior) and persists env. |
| skills/pixels-install/scripts/install_jdk.sh | Installs/verifies JDK (with reuse-if-satisfied behavior) and persists env. |
| skills/pixels-install/scripts/install_etcd.sh | Installs/configures etcd, with guardrails for remote bind + optional systemd. |
| skills/pixels-install/scripts/configure_pixels.sh | Updates pixels.properties and workers file from deployment + secrets env. |
| skills/pixels-install/scripts/check_prerequisites.sh | System preflight checks with structured “run all checks then summarize” output. |
| skills/pixels-install/scripts/build_pixels_trino_artifacts.sh | Builds pixels-trino artifacts once and records zip paths for cluster installs. |
| skills/pixels-install/scripts/build_install_pixels.sh | Runs Pixels install into PIXELS_HOME and ensures MySQL connector jar is present. |
| skills/pixels-install/codex/SKILL.md | Codex entrypoint with detailed workflow/guardrails for guided installs. |
| skills/pixels-install/claude/agent.md | Claude agent entrypoint with workflow/guardrails mirroring the Codex entrypoint. |
| skills/list.sh | Lists available skills (directories containing skill.yaml). |
| skills/install.sh | Installs skills into Codex/Claude discovery paths, copying runtime assets. |
| AGENTS.md | Notes pixels-install as an optional guided deployment helper. |
| .gitignore | Adds .agents/ to ignored AI tool state. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new
pixels-installskill for guided Pixels installation and deployment. The skill supports both Codex and Claude entrypoints while sharing one set of runtime scripts underskills/pixels-install.