jj bookmark create requires -r flag for revision. Added push section
for PR workflows using --named flag.

Assisted-by: Claude Opus 4.5 via Claude Code

diff --git a/ai/claude/skills/buildkite/SKILL.md b/ai/claude/skills/buildkite/SKILL.md
new file mode 100644
index 00000000..105d4ba0
--- /dev/null
+++ b/ai/claude/skills/buildkite/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: buildkite
+description: Use when needing bk CLI command reference, syntax, or behavior - directs to bk --help for authoritative documentation and flags
+---
+
+# Buildkite CLI (bk)
+
+Use `bk --help` for authoritative command reference and current flags.
+
+## Quick Start
+
+Run `bk <command> --help` for detailed command documentation:
+
+```bash
+bk --help              # Full command list
+bk build view --help   # Specific command details
+bk job log --help      # Syntax and options
+```
+
+## Core Workflows
+
+**View current build:**
+```bash
+bk build view          # Current branch's latest build
+bk build watch         # Watch build progress in real-time
+```
+
+**Work with jobs:**
+```bash
+bk job list            # List jobs in current build
+bk job log <job-id>    # Get job logs
+bk job retry <job-id>  # Retry a failed job
+```
+
+**Create builds:**
+```bash
+bk build create        # Trigger new build for current branch
+bk build rebuild       # Rebuild a previous build
+```
+
+## Command Categories
+
+Run `bk --help` to see all commands. Main categories:
+
+Builds: build view, build list, build create, build watch, build cancel, build rebuild
+Jobs: job list, job log, job retry, job cancel, job unblock
+Pipelines: pipeline list, pipeline view, pipeline validate, pipeline create
+Artifacts: artifacts list, artifacts download
+Agents: agent list, agent view, agent pause, agent resume, agent stop
+Config: config list, config get, config set, configure add
+API: api (direct API calls)
+
+## Global Flags
+
+```bash
+-y, --yes        # Skip confirmation prompts
+--no-input       # Disable interactive prompts
+-q, --quiet      # Suppress progress output
+--debug          # Enable debug output for API calls
+```
+
+## When to Use bk --help
+
+Direct command help is always more current than documentation. Use it for:
+
+- Exact flag names and syntax
+- Current command options
+- Command behavior details
+- Examples and edge cases
+
+Never rely on this skill's command list as authoritative. Always run `bk <command> --help` to verify behavior, flags, and current options.
diff --git a/ai/claude/skills/jj/SKILL.md b/ai/claude/skills/jj/SKILL.md
index 57d91718..abc34de2 100644
--- a/ai/claude/skills/jj/SKILL.md
+++ b/ai/claude/skills/jj/SKILL.md
@@ -33,7 +33,7 @@ No staging area: working copy changes map directly to commits. Operations are im
 In jj, **bookmarks** are named references to commits, similar to git branches. Create and manage them:
 
 ```bash
-jj bookmark create feature-auth main       # Create bookmark from main
+jj bookmark create feature-auth -r main    # Create bookmark from main
 jj bookmark list                           # Show all bookmarks
 jj bookmark list -r feature-auth           # Show specific bookmark
 jj bookmark delete feature-auth            # Delete bookmark
@@ -48,6 +48,21 @@ jj bookmark set feature-auth -r <rev>      # Move bookmark to different commit
 
 **Use bookmarks for:** Feature branches, parallel work, named release points. NOT for temporary work (use detached state instead).
 
+## Pushing to Remote
+
+```bash
+# Push existing tracked bookmarks
+jj git push -b <bookmark-name>
+
+# Create and push new bookmark in one step (preferred)
+jj git push --named <bookmark-name>=<revision>
+
+# Push all bookmarks including new ones
+jj git push --all
+```
+
+**Note:** `--named` creates the bookmark, pushes it, and auto-tracks it. Use this for PRs.
+
 ## Command Categories
 
 Run `jj --help` to see all commands. Main categories: