k8s-agent-skills 1.4.0 → 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aidas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,14 @@
 # k8s-agent-skills
 
+[![npm version](https://img.shields.io/npm/v/k8s-agent-skills?logo=npm)](https://www.npmjs.com/package/k8s-agent-skills)
+[![license](https://img.shields.io/github/license/Aidas-dev/k8s-agent-skills)](LICENSE)
+[![Publish](https://github.com/Aidas-dev/k8s-agent-skills/actions/workflows/publish.yml/badge.svg)](https://github.com/Aidas-dev/k8s-agent-skills/actions/workflows/publish.yml)
+[![GitHub stars](https://img.shields.io/github/stars/Aidas-dev/k8s-agent-skills?style=flat)](https://github.com/Aidas-dev/k8s-agent-skills)
+
 Agent skills for Kubernetes cluster operations tooling. Each skill is a self-contained `SKILL.md` designed for agentic AI tools (Claude Code, OpenCode, Codex) that load skills for task-specific expertise.
 
-**Mirror:** [github.com/Aidas-dev/k8s-agent-skills](https://github.com/Aidas-dev/k8s-agent-skills)
+**npm:** [`k8s-agent-skills`](https://www.npmjs.com/package/k8s-agent-skills)
+**GitHub:** [`Aidas-dev/k8s-agent-skills`](https://github.com/Aidas-dev/k8s-agent-skills)
 
 ## Skills
 
@@ -66,9 +72,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,13 +101,19 @@ 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.
+
+```bash
+# Bump version
+npm version patch  # or minor / major
+
+# Tag and push
+git push origin main --tags
+git push github main --tags
+```
 
-**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
+Or manually: `git tag vX.Y.Z && git push origin main --tags && git push github main --tags`.
 
 ## License
 
-MIT — free to use, modify, and distribute.
+[MIT](LICENSE) — free to use, modify, and distribute.

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.4.0",
+  "version": "1.6.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",