ascii-supply-networks/dagster-slurm/stax

Claude Code and agent skill by ascii-supply-networks/dagster-slurm

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when working with stacked Git branches or PRs using stax, including creating, inserting, submitting, restacking, merging, repairing stacks, resolving conflicts, checking CI, and using stax lanes/worktrees for isolated agent work.

Install

npx vskill@latest install ascii-supply-networks/dagster-slurm/stax

SKILL.md

Stax Skills for AI Coding Agents

This document teaches AI coding agents (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) how to use stax to manage stacked Git branches and PRs.

Installing this skill: run stax skills update (or st setup --install-skills). Per-agent setup details live in docs/integrations/.

What is Stax?

Stax manages stacked branches: small focused branches layered on top of each other. Each branch maps to one PR targeting its parent branch.

Core Concepts

  • Stack: A chain of branches where each branch builds on its parent
  • Trunk: The main branch (main or master)
  • Parent: The branch a stacked branch is based on
  • Tracked branch: A branch with stax metadata (parent and PR linkage)

Command Map

bash
stax status|ls                # Stack status (tree)
stax ll                        # Stack status with PR URLs/details
stax log|l                     # Stack status with commits + PR info
stax gui [path]                # Launch fresh native macOS GUI preview for one repository
 
stax submit|ss                 # Submit full stack
stax stack link                # Register current PR stack as native GitHub Stack (GitHub + gh-stack)
stax stack unlink              # Unstack locally tracked native stack; stax-linked stacks may need gh stack checkout <pr>
stax merge                     # Merge PRs from stack bottom upward
stax sync|rs                   # Sync trunk + clean merged branches
stax sweep                     # Classify + optionally delete merged/gone/stale branches
stax restack                   # Rebase branch/stack onto parents
stax cascade                   # Restack bottom-up and submit updates
 
stax get [branch|PR]           # Sync current stack, or fetch/checkout a remote branch or PR stack
stax checkout|co|bco           # Checkout branch (interactive by default)
stax trunk|t                   # Checkout trunk
stax trunk <branch>            # Set trunk branch
stax up|u [n]                  # Move to child branch
stax down|d [n]                # Move to parent branch
stax top                       # Move to stack tip
stax bottom                    # Move to first branch above trunk
stax prev|p                    # Checkout previous branch
 
stax branch ...|b              # Branch subcommands
stax upstack ...|us            # Descendant-scope commands
stax downstack ...|ds          # Ancestor-scope commands
 
stax create|c|add              # Create stacked branch (--ai can name it from changes)
stax modify|m                  # Amend current commit (menu when nothing staged)
stax rename                    # Rename current branch
stax detach                    # Remove branch from stack, reparent children
stax reorder                   # Interactive stack reorder
stax split                     # Interactive branch split into stack
 
stax continue|cont             # Continue after conflict resolution
stax abort                     # Abort in-progress rebase/conflict flow
stax undo [op-id]              # Undo last/specific operation
stax redo [op-id]              # Redo last/specific undone operation
 
stax pr                        # Open current branch PR
stax pr body                   # Print current PR description
stax pr body --edit            # Edit current PR description in $EDITOR
stax ready                     # Interactive PR readiness dashboard for all tracked PRs, newest changed first (merge/ping/fix/wait/draft)
stax ready --current           # Readiness dashboard for current stack only
stax ready --stack             # Same as --current
stax ready --plain             # Static readiness table for captured/non-interactive output
stax pr list --ready           # Same readiness view under PR list
stax ready --all               # Explicit all tracked branch PRs (default)
stax issue list                # List open issues
stax open                      # Open repo in browser
stax comments                  # Show current PR comments
stax reviews --stack           # Review/comment inbox; GitHub review comments include inline file/line locations
stax reviews --all --json      # Machine-readable inbox for every tracked PR
stax copy [--pr]               # Copy branch name or PR URL
stax ci [--oneline|-1]         # CI status (per-check table; --oneline / multi-branch = one line per branch)
stax standup                   # Recent activity summary
stax standup --ai              # AI-generated spoken standup update (colored card)
stax standup --ai --style slack  # AI-generated Slack-ready Yesterday/Today bullets
stax standup --ai --jit   # AI standup plus Jira next-up context via jit (github.com/cesarferreira/jit)
stax changelog <from> [to]     # Changelog between refs
stax changelog find [query]    # Fuzzy-find commits in the changelog range
stax changelog --find [query]  # Flag form of commit fuzzy-find
stax generate                  # Interactive picker: PR body, PR title, or commit message (AI)
stax gen --pr-body             # Non-interactive: refresh open PR body from diff
stax gen --pr-title            # Non-interactive: refresh open PR title from diff
stax gen --commit-msg          # Non-interactive: amend HEAD commit message from diff
 
stax auth [status]             # GitHub auth setup/status
stax config                    # Print config path + contents
stax cli upgrade               # Detect the install method and run the matching upgrade flow
stax doctor                    # Health checks (also reports stale skill files)
stax doctor --fix              # Show one repair plan, then apply safe local fixes after confirmation
stax validate                  # Validate stack metadata
stax fix                       # Auto-repair metadata
stax test <cmd...>             # Run command on each branch
stax demo                      # Interactive tutorial
 
stax skills                    # List installed AI agent skill files + version status
stax skills list               # Same as above
stax skills update             # Download latest skills from GitHub and update all installed files
stax skills update --dry-run   # Preview what would be updated without writing
 
stax lane [name] [prompt]      # Open interactive lane picker, or start/resume named AI lane
stax absorb                    # Absorb staged changes into correct stack branches
stax edit|e                    # Interactively edit commits (reword, squash, fixup, drop)
 
stax worktree create [branch]  # Create a worktree for an existing local/fetched remote/new branch
stax worktree list             # List all worktrees (* = current)
stax worktree ll               # Richer worktree status (managed/prunable/conflict state)
stax worktree go <name>        # Navigate to a worktree (requires shell integration)
stax worktree path <name>      # Print absolute path of a worktree (for scripting)
stax worktree remove <name>    # Remove a worktree
stax worktree promote          # Retire current lane + check its branch out in main worktree
stax worktree cleanup          # Prune stale bookkeeping + bulk-remove merged/detached worktrees
stax worktree restack          # Restack all stax-managed worktrees
stax setup                     # Install shell integration, then optionally offer AI agent skills + auth onboarding
stax setup --yes               # Accept shell setup defaults, install skills, and import auth from gh when available
stax setup --install-skills    # Install shell integration and accept the skills install automatically
stax setup --skip-skills       # Install shell integration without the skills prompt
stax setup --auth-from-gh      # Install shell integration and import GitHub auth from gh without prompting
stax setup --skip-auth         # Install shell integration without the auth onboarding step
stax setup --print             # Print shell integration snippet for manual install
 
# Worktree shortcuts
stax wt                        # Open worktree dashboard (TTY) or print worktree help
stax w                         # List worktrees
stax wtc [branch]              # Create worktree (local branch, fetched remote branch, or new branch)
stax wtls                      # List worktrees
stax wtll                      # Long worktree list
stax wtgo <name>               # Navigate to worktree path
stax wtrm <name>               # Remove worktree
stax wtrs                      # Restack all stax-managed worktrees
sw <name>                      # Quick-switch (shell alias installed by stax setup)

High-Value Commands and Flags

Contributor Release Workflow
bash
make release                     # Run cargo release (minor); git-cliff regenerates CHANGELOG.md inside the release commit
make release LEVEL=patch         # Same flow with a patch bump
make release LEVEL=major         # Same flow with a major bump
cargo release patch --no-confirm # Dry-run cargo release only (no bump/tag/push)

Release prep regenerates CHANGELOG.md with git-cliff (config in cliff.toml) inside cargo release's pre-release hook, grouping the commits since the latest v* tag under the new version. Conventional prefixes map to grouped sections (feat → Features, fix → Bug Fixes, docs → Documentation, etc.); non-conventional subjects land in Other rather than being dropped. git-cliff must be installed locally (cargo install git-cliff).

Native macOS GUI
bash
make gui-app                     # Build target/gui-app/Stax.app
make install-gui-app             # Install $HOME/Applications/Stax.app
make gui-release                 # Package the native architecture release zip
make gui-release-test            # Validate ad-hoc/signed/notarized configuration + package
stax gui                         # Launch GUI for the current directory
stax gui /path/to/repo           # Launch GUI for an explicit repository

Public GitHub Releases include Stax-aarch64-apple-darwin.zip and Stax-x86_64-apple-darwin.zip; extract the matching archive and move Stax.app to /Applications. The app is a separate artifact, not a new package, so it does not enlarge the CLI binaries. Ad-hoc-signed builds must be opened once to trigger Gatekeeper, then approved with Privacy & Security → Open Anyway; never disable Gatekeeper globally. The final bundle id is com.cesarferreira.stax.

stax gui [path] is macOS-only. It canonicalizes the supplied path, defaults to the current directory, and launches exactly open -n -b com.cesarferreira.stax --args <canonical-path>. The -n fresh-instance behavior is intentional: every invocation opens a new app process/window for one repository.

GUI operations are typed and repository-scoped. It can search branches; checkout, create, rename, delete, move, and reorder eligible local branches; restack selected/all; submit the current stack as Draft; Open PR without checkout; and undo/redo receipts whose transaction is fully local. Rename does not push. Delete shows descendants. Move/reorder/restack dirty-worktree recovery requires an explicit auto-stash confirmation. / focuses search, 1/2/3 toggle panes, draggable widths and visibility persist per canonical repository, and all enabled visible actions are keyboard-operable with visible focus and textual labels. GUI submit has no CLI prompts and does not auto-open PR pages. Keep AI naming, staging/commit creation, --below, --insert, custom prefixes, advanced submit options, and remote-effect recovery in CLI workflows.

Create and Edit Branches

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
58
Repository forks
12
7-day trend score
20

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ascii-supply-networks/dagster-slurm/stax/badge)](https://verified-skill.com/skills/ascii-supply-networks/dagster-slurm/stax)

Something wrong with this skill or its page? Tell us.