k8s-agent-skills 1.3.0 → 1.5.0

package/README.md

@@ -66,9 +66,14 @@ npm install --save-dev k8s-agent-skills
 # or
 bun add -d k8s-agent-skills
 
-# Symlink skills to agent config dir
-npx skills-npm
-# → symlinks skills/ into ~/.agents/skills/
+# Symlink all skills to ~/.agents/skills/ (OpenCode)
+npx skills-link
+
+# Or to other agent directories:
+npx skills-link --claude     # Claude Code  (~/.claude/skills/)
+npx skills-link --codex      # Codex CLI    (~/.codex/skills/)
+npx skills-link --cursor     # Cursor       (~/.cursor/skills/)
+npx skills-link --all        # all known agent dirs
 ```
 
 ### Via git clone
@@ -90,12 +95,18 @@ cp -r skills/external-dns ~/.claude/skills/
 
 ## npm Publishing
 
-The package auto-publishes to npm on push to `main` via GitHub Actions.
+Auto-publishes on `v*` tag push via GitHub Actions with OIDC Trusted Publisher — no tokens needed.
 
-**Setup required** (one-time):
-1. Create an npm automation token at [npmjs.com/settings/tokens](https://www.npmjs.com/settings/tokens)
-2. Add it as `NPM_TOKEN` secret in the GitHub repo settings
-3. Workflow at `.github/workflows/publish.yml` handles version bump and publish
+```bash
+# Bump version
+npm version patch  # or minor / major
+
+# Tag and push
+git push origin main --tags
+git push github main --tags
+```
+
+Or manually: `git tag vX.Y.Z && git push origin main --tags && git push github main --tags`.
 
 ## License
 

package/bin/skills-link

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# skills-link — Symlink k8s-agent-skills to agent skill directories
+# Usage:
+#   skills-link                    # link to ~/.agents/skills/ (OpenCode)
+#   skills-link --claude           # link to ~/.claude/skills/  (Claude Code)
+#   skills-link --codex            # link to ~/.codex/skills/  (Codex CLI)
+#   skills-link --cursor           # link to ~/.cursor/skills/ (Cursor)
+#   skills-link --all              # link to all known agent dirs
+#
+# Cleans up broken symlinks (removed skills) before linking.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+# Package root is parent of bin/
+PKG_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+SKILLS_DIR="$PKG_DIR/skills"
+
+if [ ! -d "$SKILLS_DIR" ]; then
+  echo "ERROR: skills/ not found at $SKILLS_DIR" >&2
+  echo "Run this script from within the k8s-agent-skills package." >&2
+  exit 1
+fi
+
+declare -a TARGETS
+
+# Default target
+TARGETS+=("$HOME/.agents/skills")
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --claude)   TARGETS+=("$HOME/.claude/skills")    ;;
+    --codex)    TARGETS+=("$HOME/.codex/skills")      ;;
+    --cursor)   TARGETS+=("$HOME/.cursor/skills")     ;;
+    --agents)   TARGETS+=("$HOME/.agents/skills")     ;;
+    --all)
+      TARGETS+=("$HOME/.agents/skills")
+      TARGETS+=("$HOME/.claude/skills")
+      TARGETS+=("$HOME/.codex/skills")
+      TARGETS+=("$HOME/.cursor/skills")
+      ;;
+    --help|-h)
+      echo "Usage: skills-link [--claude] [--codex] [--cursor] [--agents] [--all]"
+      echo "Default: ~/.agents/skills/ (OpenCode)"
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      echo "Usage: skills-link [--claude] [--codex] [--cursor] [--agents] [--all]" >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+# Deduplicate targets
+declare -a UNIQUE
+for t in "${TARGETS[@]}"; do
+  seen=false
+  for u in "${UNIQUE[@]}"; do
+    [ "$u" = "$t" ] && seen=true && break
+  done
+  $seen || UNIQUE+=("$t")
+done
+
+for TARGET in "${UNIQUE[@]}"; do
+  mkdir -p "$TARGET"
+
+  # Cleanup broken symlinks (skills removed from package)
+  broken=0
+  while IFS= read -r -d '' link; do
+    if [ ! -e "$link" ]; then
+      rm -f "$link"
+      broken=$((broken + 1))
+    fi
+  done < <(find "$TARGET" -maxdepth 1 -type l -name '*' -print0 2>/dev/null || true)
+
+  # Symlink each skill
+  linked=0
+  skipped=0
+  migrated=0
+  for skill_dir in "$SKILLS_DIR"/*/; do
+    [ -d "$skill_dir" ] || continue
+    skill_name="$(basename "$skill_dir")"
+    link_path="$TARGET/$skill_name"
+
+    # Check if symlink already points to the right place
+    if [ -L "$link_path" ] && [ "$(readlink "$link_path")" = "$skill_dir" ]; then
+      skipped=$((skipped + 1))
+      continue
+    fi
+
+    # Handle existing entry at link_path
+    if [ -e "$link_path" ] || [ -L "$link_path" ]; then
+      if [ -L "$link_path" ]; then
+        rm -f "$link_path"
+      elif [ -d "$link_path" ] && [ -f "$link_path/SKILL.md" ]; then
+        # Old-style skill directory (copied, not symlinked) — replace with symlink
+        rm -rf "$link_path"
+        migrated=$((migrated + 1))
+      else
+        echo "  WARN: $link_path exists and is not a symlink — skipping" >&2
+        continue
+      fi
+    fi
+
+    ln -sf "$skill_dir" "$link_path"
+    linked=$((linked + 1))
+  done
+
+  echo "[$TARGET] linked $linked skill(s), $skipped up-to-date, $migrated migrated, $broken stale symlink(s) removed"
+done

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "k8s-agent-skills",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "private": false,
   "description": "Agent skills for Kubernetes cluster operations — Cilium, Talos, Flux, Rook-Ceph, CNPG, Gitea, Tekton, Cert-Manager, VictoriaMetrics, ZITADEL, Harbor, Higress, KServe, Kubeflow, MariaDB, Vector, ExternalDNS, Dragonfly, Flagger, Sealed Secrets, Stakater Reloader, NVIDIA GPU, Atlas",
   "files": [
-    "skills"
+    "skills",
+    "bin"
   ],
+  "bin": {
+    "skills-link": "./bin/skills-link"
+  },
   "keywords": [
     "ai-agent-skill",
     "kubernetes",