@anionzo/skill 1.6.0 → 1.7.0

package/README.md

@@ -4,7 +4,7 @@
 
 **A vendor-neutral, multi-agent skill library for AI-powered software engineering**
 
-[![Skills](https://img.shields.io/badge/skills-15-blue?style=flat-square&logo=bookstack)](skills/)
+[![Skills](https://img.shields.io/badge/skills-13-blue?style=flat-square&logo=bookstack)](skills/)
 [![Knowledge](https://img.shields.io/badge/knowledge-5_files-green?style=flat-square&logo=readme)](knowledge/)
 [![Platforms](https://img.shields.io/badge/platforms-5_agents-purple?style=flat-square&logo=robot-framework)](adapters/)
 [![License](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
@@ -23,6 +23,8 @@
 
 This repo is intentionally lighter than a full workflow product. It borrows the **workflow-first** mindset from `hoangnb24/skills`, the **plan-first** behavior from modern coding agents like OpenCode, and the **multi-platform** approach from `knowns-dev/knowns` — then turns them into a practical personal library.
 
+The current library is intentionally consolidated: it keeps **13 higher-signal skills** instead of splitting every adjacent workflow into separate names. Overlapping flows such as repo onboarding, session handoff, and end-to-end go mode are folded into stronger core skills (`research`, `extract`, and `planning`) to reduce routing noise.
+
 ### 🏗️ Design Goals
 
 | | Goal |
@@ -48,13 +50,14 @@ This repo is intentionally lighter than a full workflow product. It borrows the
 
 ### 🎯 Skill Catalog
 
+This catalog is intentionally compact: each skill should own a clearly distinct job, and nearby workflows are merged unless the risk profile or working mode is meaningfully different.
+
 | | Skill | Purpose |
 |---|---|---|
 | 🧭 | `using-skills` | Route a request to the right skill and working mode |
 | 💡 | `brainstorming` | Explore ideas, lock decisions, optionally write a spec |
-| 🗺️ | `repo-onboarding` | Understand an unfamiliar codebase before acting |
 | 🔎 | `research` | Explore existing code and patterns before implementing |
-| 📐 | `planning` | Execution-ready plans with bite-sized steps and no placeholders |
+| 📐 | `planning` | Execution-ready plans, plus optional go-mode execution for approved work |
 | 🚀 | `feature-delivery` | Implement a feature with minimal, repo-aligned change |
 | 🧪 | `test-driven-development` | Enforce test-first discipline with red-green-refactor |
 | 🐛 | `debug` | 4-phase systematic debugging with root cause investigation |
@@ -63,20 +66,19 @@ This repo is intentionally lighter than a full workflow product. It borrows the
 | 🔍 | `code-review` | Give and receive code reviews with severity triage |
 | 📝 | `commit` | Create conventional commits with staged change review |
 | 📖 | `docs-writer` | Update docs from verified source behavior |
-| 🧬 | `extract` | Extract patterns, decisions, and learnings from work |
-| ⚡ | `go-pipeline` | Execute a full spec-to-commit pipeline in one run |
+| 🧬 | `extract` | Extract durable learnings or compress active work into a handoff |
 
 ### 🔄 Default Workflow
 
 ```
 ┌─────────────┐     ┌───────────────┐     ┌─────────────────┐
-│ using-skills │────▶│ brainstorming │────▶│ repo-onboarding │
-│   (router)   │     │  (if vague)   │     │  (if new repo)  │
-└──────┬───────┘     └───────┬───────┘     └────────┬────────┘
-       │                     │                      │
-       │                     ▼                      │
-       │              ┌──────────┐                  │
-       └─────────────▶│ planning │◀─────────────────┘
+│ using-skills │────▶│ brainstorming │────▶│  research  │
+│   (router)   │     │  (if vague)   │     │ (if needed) │
+└──────┬───────┘     └───────┬───────┘     └──────┬──────┘
+       │                     │                     │
+       │                     ▼                     │
+       │              ┌──────────┐                 │
+       └─────────────▶│ planning │◀────────────────┘
                       └────┬─────┘
                            │
               ┌────────────┼────────────┐
@@ -100,6 +102,10 @@ This repo is intentionally lighter than a full workflow product. It borrows the
                           ▼
                     ┌──────────┐
                     │  commit  │
+                    └────┬─────┘
+                         ▼
+                    ┌──────────┐
+                    │ extract  │
                     └──────────┘
 ```
 
@@ -117,23 +123,63 @@ This scaffold distills patterns from strong public repos:
 
 ### 🚀 Quick Start
 
+#### Use the library
+
+If you just want to use the skill library in your agent:
+
+```bash
+# 1. Install the library into your current project or workspace
+npx @anionzo/skill
+
+# 2. Open your agent in the target repo
+# Then start with the router skill
+an:using-skills
+
+# 3. Ask naturally, for example:
+# "Help me understand this repo"
+# "Plan this feature first"
+# "Review these changes"
+```
+
+The router will pick the right primary skill and next step.
+
+Installer behavior:
+
+- `npx @anionzo/skill` opens an interactive terminal picker
+- use **arrow keys** to move
+- press **space** to select one or more platforms
+- press **enter** to install the selected platforms
+- you can also choose whether to update `.gitignore` with the installed agent files
+- `npm install @anionzo/skill` still runs in silent postinstall mode and installs the default skill directories automatically
+
+#### Edit or extend the library
+
+If you want to customize this repository itself:
+
 ```bash
-# 1. Understand the repo shape
-cat docs/design-brief.md
+# 1. Read the design and authoring docs
+less docs/design-brief.md
+less docs/authoring-guide.md
 
-# 2. Customize knowledge to your preferences
+# 2. Adjust global knowledge if you want different defaults
 vim knowledge/global/engineering-principles.md
 
-# 3. Start working — the router picks the right skill
-cat skills/using-skills/SKILL.md
+# 3. Edit skills, docs, or adapters
+vim skills/using-skills/SKILL.md
 
-# 4. Validate your skills
+# 4. Validate the library structure
 bash scripts/validate-skills
 
-# 5. Generate platform files
+# 5. Regenerate platform files after skill/knowledge changes
 bash scripts/sync-platform-files
 ```
 
+Notes:
+
+- `bash scripts/validate-skills` checks required files, metadata keys, and basic library consistency.
+- `bash scripts/sync-platform-files` regenerates the files in `generated/` for each target agent.
+- You only need to run sync when skills, knowledge, adapters, or summaries change.
+
 ### 📦 Install via npm
 
 > Available on [npm](https://www.npmjs.com/package/@anionzo/skill) — no authentication required

package/docs/design-brief.md

@@ -75,13 +75,12 @@ A personal operating library with three layers:
 
 ### 🎯 Current Scope
 
-The library has expanded beyond the original v1 scope. The current skill set covers 15 repeatable work patterns:
+The library has expanded beyond the original v1 scope. The current skill set covers 13 repeatable work patterns:
 
 - 🧭 Routing requests with `using-skills`
 - 💡 Refining ideas and writing specs with `brainstorming`
-- 🗺️ Onboarding into unfamiliar repos with `repo-onboarding`
 - 🔎 Researching existing code and patterns with `research`
-- 📐 Planning implementation work before code edits with `planning`
+- 📐 Planning implementation work before code edits, or running approved work in go mode, with `planning`
 - 🚀 Delivering features with `feature-delivery`
 - 🧪 Implementing with test-first discipline through `test-driven-development`
 - 🐛 Systematically debugging failures with `debug`
@@ -90,8 +89,7 @@ The library has expanded beyond the original v1 scope. The current skill set cov
 - 🔍 Giving and receiving code reviews with `code-review`
 - 📝 Creating intentional commits with `commit`
 - 📖 Updating docs with `docs-writer`
-- 🧬 Extracting reusable learnings with `extract`
-- ⚡ Running an approved spec-to-commit flow with `go-pipeline`
+- 🧬 Extracting reusable learnings or handing work off between sessions with `extract`
 
 ### 🔮 Next Steps
 

package/docs/knowledge-spec.md

@@ -43,6 +43,7 @@ Use for session-scoped or temporary notes:
 - 🧪 Active hypotheses
 - ⏳ Temporary decisions
 - 📌 Follow-ups to promote later
+- 🪄 Session handoff summaries for unfinished work
 
 > ⚡ This layer changes **often** and can be cleaned up aggressively.
 

package/i18n/README.vi.md

@@ -4,7 +4,7 @@
 
 **Thư viện skill đa agent, vendor-neutral cho kỹ thuật phần mềm hỗ trợ AI**
 
-[![Skills](https://img.shields.io/badge/skills-15-blue?style=flat-square&logo=bookstack)](../skills/)
+[![Skills](https://img.shields.io/badge/skills-13-blue?style=flat-square&logo=bookstack)](../skills/)
 [![Knowledge](https://img.shields.io/badge/knowledge-5_files-green?style=flat-square&logo=readme)](../knowledge/)
 [![Platforms](https://img.shields.io/badge/platforms-5_agents-purple?style=flat-square&logo=robot-framework)](../adapters/)
 [![License](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](../LICENSE)
@@ -23,6 +23,8 @@
 
 Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy **workflow-first** từ `hoangnb24/skills`, hành vi **plan-first** từ các coding agent hiện đại như OpenCode, và tư duy **multi-platform** từ `knowns-dev/knowns` — rồi biến chúng thành thư viện cá nhân thực dụng.
 
+Thư viện hiện tại được cô đọng có chủ đích: giữ **13 skill sắc nét hơn** thay vì tách mỗi workflow gần nhau thành một tên riêng. Các luồng bị chồng lắp như onboarding repo, handoff giữa session, và go mode end-to-end đã được nhập vào các skill lõi mạnh hơn (`research`, `extract`, và `planning`) để giảm nhiễu khi route.
+
 ### 🏗️ Mục Tiêu Thiết Kế
 
 | | Mục tiêu |
@@ -48,13 +50,14 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
 
 ### 🎯 Danh Mục Skill
 
+Catalog này được giữ gọn có chủ đích: mỗi skill nên sở hữu một nhiệm vụ thật sự khác biệt, còn các workflow gần nhau sẽ được gộp lại trừ khi mức rủi ro hoặc cách làm việc khác nhau rõ rệt.
+
 | | Skill | Mục đích |
 |---|---|---|
 | 🧭 | `using-skills` | Phân loại request và chọn đúng skill |
 | 💡 | `brainstorming` | Khám phá ý tưởng, khóa quyết định, viết spec nếu cần |
-| 🗺️ | `repo-onboarding` | Hiểu codebase lạ trước khi hành động |
 | 🔎 | `research` | Tìm hiểu code và pattern có sẵn trước khi implement |
-| 📐 | `planning` | Plan thực thi với bước nhỏ gọn, không placeholder |
+| 📐 | `planning` | Plan thực thi, kèm go mode cho công việc đã rõ và đã duyệt |
 | 🚀 | `feature-delivery` | Triển khai feature với thay đổi tối thiểu, phù hợp repo |
 | 🧪 | `test-driven-development` | Kỷ luật test-first với chu trình red-green-refactor |
 | 🐛 | `debug` | Gỡ lỗi hệ thống 4 giai đoạn với điều tra nguyên nhân gốc |
@@ -63,20 +66,19 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
 | 🔍 | `code-review` | Cho và nhận code review với phân loại mức độ |
 | 📝 | `commit` | Tạo commit conventional với review thay đổi staged |
 | 📖 | `docs-writer` | Cập nhật docs từ hành vi thực tế đã xác minh |
-| 🧬 | `extract` | Trích xuất pattern, quyết định, bài học từ công việc |
-| ⚡ | `go-pipeline` | Thực thi pipeline spec-to-commit trong một lượt |
+| 🧬 | `extract` | Trích xuất bài học bền vững hoặc cô đọng công việc đang dở thành handoff |
 
 ### 🔄 Workflow Mặc Định
 
 ```
 ┌─────────────┐     ┌───────────────┐     ┌─────────────────┐
-│ using-skills │────▶│ brainstorming │────▶│ repo-onboarding │
-│  (router)    │     │ (nếu mơ hồ)  │     │ (nếu repo lạ)   │
-└──────┬───────┘     └───────┬───────┘     └────────┬────────┘
-       │                     │                      │
-       │                     ▼                      │
-       │              ┌──────────┐                  │
-       └─────────────▶│ planning │◀─────────────────┘
+│ using-skills │────▶│ brainstorming │────▶│  research  │
+│  (router)    │     │ (nếu mơ hồ)  │     │ (nếu cần)   │
+└──────┬───────┘     └───────┬───────┘     └──────┬──────┘
+       │                     │                     │
+       │                     ▼                     │
+       │              ┌──────────┐                 │
+       └─────────────▶│ planning │◀────────────────┘
                       └────┬─────┘
                            │
               ┌────────────┼────────────┐
@@ -100,6 +102,10 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
                           ▼
                     ┌──────────┐
                     │  commit  │
+                    └────┬─────┘
+                         ▼
+                    ┌──────────┐
+                    │ extract  │
                     └──────────┘
 ```
 
@@ -115,23 +121,63 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
 
 ### 🚀 Bắt Đầu Nhanh
 
+#### Dùng thư viện
+
+Nếu bạn chỉ muốn dùng skill library trong agent của mình:
+
+```bash
+# 1. Cài thư viện vào project hoặc workspace hiện tại
+npx @anionzo/skill
+
+# 2. Mở agent trong repo đích
+# Sau đó bắt đầu bằng router skill
+an:using-skills
+
+# 3. Hỏi tự nhiên, ví dụ:
+# "Help me understand this repo"
+# "Plan this feature first"
+# "Review these changes"
+```
+
+Router sẽ chọn đúng skill chính và bước tiếp theo.
+
+Hành vi của installer:
+
+- `npx @anionzo/skill` sẽ mở terminal picker tương tác
+- dùng **phím mũi tên** để di chuyển
+- nhấn **space** để chọn một hoặc nhiều platform
+- nhấn **enter** để cài các platform đã chọn
+- bạn cũng có thể chọn cập nhật `.gitignore` cho các file agent vừa cài
+- `npm install @anionzo/skill` vẫn chạy theo postinstall silent mode và tự cài các thư mục skill mặc định
+
+#### Sửa hoặc mở rộng thư viện
+
+Nếu bạn muốn tùy biến chính repo này:
+
 ```bash
-# 1. Hiểu hình dạng repo
-cat docs/design-brief.md
+# 1. Đọc tài liệu thiết kế và quy tắc viết
+less docs/design-brief.md
+less docs/authoring-guide.md
 
-# 2. Tùy chỉnh knowledge theo phong cách của bạn
+# 2. Chỉnh knowledge global nếu muốn đổi default behavior
 vim knowledge/global/engineering-principles.md
 
-# 3. Bắt đầu — router sẽ chọn đúng skill
-cat skills/using-skills/SKILL.md
+# 3. Sửa skill, docs, hoặc adapters
+vim skills/using-skills/SKILL.md
 
-# 4. Validate các skill
+# 4. Validate cấu trúc thư viện
 bash scripts/validate-skills
 
-# 5. Sinh platform file
+# 5. Sinh lại platform file sau khi đổi skill/knowledge
 bash scripts/sync-platform-files
 ```
 
+Ghi chú:
+
+- `bash scripts/validate-skills` kiểm tra file bắt buộc, key metadata, và tính nhất quán cơ bản của thư viện.
+- `bash scripts/sync-platform-files` sinh lại các file trong `generated/` cho từng agent đích.
+- Chỉ cần chạy sync khi skill, knowledge, adapter, hoặc summary thay đổi.
+
 ### 📦 Cài Đặt Qua npm
 
 > Có sẵn trên [npm](https://www.npmjs.com/package/@anionzo/skill) — không cần xác thực

package/i18n/design-brief.vi.md

@@ -75,13 +75,12 @@ Thư viện vận hành cá nhân với ba lớp:
 
 ### 🎯 Phạm Vi Hiện Tại
 
-Thư viện đã mở rộng vượt quá phạm vi v1 ban đầu. Bộ skill hiện tại bao phủ 15 pattern công việc lặp lại:
+Thư viện đã mở rộng vượt quá phạm vi v1 ban đầu. Bộ skill hiện tại bao phủ 13 pattern công việc lặp lại:
 
 - 🧭 Phân loại request với `using-skills`
 - 💡 Làm rõ ý tưởng và viết spec với `brainstorming`
-- 🗺️ Onboard vào repo lạ với `repo-onboarding`
 - 🔎 Nghiên cứu code và pattern có sẵn với `research`
-- 📐 Lập plan trước khi code với `planning`
+- 📐 Lập plan trước khi code, hoặc chạy theo go mode khi công việc đã rõ, với `planning`
 - 🚀 Triển khai feature với `feature-delivery`
 - 🧪 Implement theo test-first với `test-driven-development`
 - 🐛 Gỡ lỗi có hệ thống với `debug`
@@ -90,8 +89,7 @@ Thư viện đã mở rộng vượt quá phạm vi v1 ban đầu. Bộ skill hi
 - 🔍 Cho và nhận code review với `code-review`
 - 📝 Tạo commit có chủ đích với `commit`
 - 📖 Cập nhật tài liệu với `docs-writer`
-- 🧬 Trích xuất bài học tái sử dụng với `extract`
-- ⚡ Chạy luồng spec-to-commit đã được duyệt với `go-pipeline`
+- 🧬 Trích xuất bài học tái sử dụng hoặc handoff công việc giữa các session với `extract`
 
 ### 🔮 Bước Tiếp Theo
 

package/i18n/knowledge-spec.vi.md

@@ -43,6 +43,7 @@ Dùng cho ghi chú tạm thời trong session:
 - 🧪 Giả thuyết đang active
 - ⏳ Quyết định tạm thời
 - 📌 Follow-up cần promote sau
+- 🪄 Tóm tắt handoff cho công việc chưa hoàn thành
 
 > ⚡ Lớp này thay đổi **thường xuyên** và có thể dọn dẹp mạnh tay.
 

package/knowledge/global/skill-triggering-rules.md

@@ -14,7 +14,7 @@ These notes keep the library behavior consistent across agents and sessions.
 - Use `test-driven-development` when implementing with TDD discipline (red-green-refactor).
 - Use `verification-before-completion` before any strong success claim.
 - Use `code-review` for review requests and post-implementation risk checks.
-- Use `repo-onboarding` when entering an unfamiliar codebase before productive work can begin.
+- Use `research` when entering an unfamiliar codebase before productive work can begin.
 - Use `docs-writer` for documentation tasks in a repo whose structure is already understood.
 - Use `refactor-safe` for restructuring, extracting, or migrating code without intended behavior change.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anionzo/skill",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Personal AI Skill Library — vendor-neutral, multi-agent skill library for AI-powered software engineering",
   "bin": {
     "anionzo-skill": "scripts/install-opencode-skills"

package/scripts/install-opencode-skills

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 
 # Install AI skills into agent-specific directories
 #
@@ -10,14 +10,20 @@
 #   npm install @anionzo/skill      # auto (postinstall)
 #   bash scripts/install-opencode-skills [project-dir]
 
-set -eu
+set -euo pipefail
 
 SCRIPT_PATH=$(readlink -f "$0" 2>/dev/null || realpath "$0" 2>/dev/null || echo "$0")
 ROOT=$(CDPATH= cd -- "$(dirname "$SCRIPT_PATH")/.." && pwd)
 
-# Determine project root: explicit arg > INIT_CWD (set by npm) > current dir
+# Determine project root:
+#   1. explicit arg
+#   2. npm_config_local_prefix during lifecycle scripts (correct for npm install --prefix)
+#   3. INIT_CWD (npm invocation cwd)
+#   4. current dir
 if [ -n "${1:-}" ]; then
   PROJECT="$1"
+elif [ "${npm_lifecycle_event:-}" = "postinstall" ] && [ -n "${npm_config_local_prefix:-}" ]; then
+  PROJECT="$npm_config_local_prefix"
 elif [ -n "${INIT_CWD:-}" ]; then
   PROJECT="$INIT_CWD"
 else
@@ -135,8 +141,180 @@ copilot||.github/copilot-instructions.md|GitHub Copilot Instructions|GitHub Copi
 # --- Interactive mode detection ---
 
 is_interactive() {
-  # postinstall (npm) sets INIT_CWD — skip interactive
-  [ -z "${INIT_CWD:-}" ] && [ -t 0 ]
+  [ "${npm_lifecycle_event:-}" != "postinstall" ] && [ -t 0 ] && [ -t 1 ]
+}
+
+# --- Interactive picker ---
+
+MENU_LABELS=(
+  "OpenCode        (.opencode/skills/ + OPENCODE.md)"
+  "Claude Code     (.claude/skills/   + CLAUDE.md)"
+  "Agents (generic)(.agents/skills/   + AGENTS.md)"
+  "Gemini CLI      (GEMINI.md)"
+  "GitHub Copilot  (.github/copilot-instructions.md)"
+  "Update .gitignore with selected platform files"
+)
+
+read_key() {
+  local key rest final
+
+  IFS= read -rsn1 key || return 1
+
+  if [ "$key" = $'\x1b' ]; then
+    IFS= read -rsn1 -t 0.1 rest || true
+    if [ "$rest" = "[" ]; then
+      IFS= read -rsn1 -t 0.1 final || true
+      printf '\033[%s' "$final"
+    else
+      printf '\033%s' "$rest"
+    fi
+    return 0
+  fi
+
+  printf '%s' "$key"
+}
+
+render_menu() {
+  local cursor="$1"
+  shift
+  local -a state=("$@")
+  local i mark prefix
+
+  printf '\033[H\033[2J'
+  printf '\n'
+  printf '  @anionzo/skill -- AI Skill Library\n'
+  printf '  ==================================\n\n'
+  printf '  Use arrow keys to move, space to toggle, enter to install.\n'
+  printf '  Press a to toggle all platforms, q to cancel.\n\n'
+
+  for i in "${!MENU_LABELS[@]}"; do
+    [ "$i" -eq 5 ] && printf '\n'
+
+    if [ "${state[$i]}" -eq 1 ]; then
+      mark='[x]'
+    else
+      mark='[ ]'
+    fi
+
+    if [ "$i" -eq "$cursor" ]; then
+      prefix='>'
+    else
+      prefix=' '
+    fi
+
+    printf '  %s %s %s\n' "$prefix" "$mark" "${MENU_LABELS[$i]}"
+  done
+
+  printf '\n'
+}
+
+toggle_all_platforms() {
+  local -n state_ref=$1
+  local sum=0
+  local i next=1
+
+  for i in 0 1 2 3 4; do
+    sum=$((sum + state_ref[$i]))
+  done
+
+  [ "$sum" -eq 5 ] && next=0
+
+  for i in 0 1 2 3 4; do
+    state_ref[$i]=$next
+  done
+}
+
+interactive_select() {
+  local cursor=0
+  local key
+  local -a selected=(0 0 0 0 0 0)
+
+  while true; do
+    render_menu "$cursor" "${selected[@]}"
+    key=$(read_key) || exit 0
+
+    case "$key" in
+      $'\033[A')
+        if [ "$cursor" -eq 0 ]; then
+          cursor=$((${#MENU_LABELS[@]} - 1))
+        else
+          cursor=$((cursor - 1))
+        fi
+        ;;
+      $'\033[B')
+        if [ "$cursor" -eq $((${#MENU_LABELS[@]} - 1)) ]; then
+          cursor=0
+        else
+          cursor=$((cursor + 1))
+        fi
+        ;;
+      "")
+        break
+        ;;
+      " ")
+        if [ "${selected[$cursor]}" -eq 1 ]; then
+          selected[$cursor]=0
+        else
+          selected[$cursor]=1
+        fi
+        ;;
+      [aA])
+        toggle_all_platforms selected
+        ;;
+      [qQ])
+        printf '\n  Cancelled.\n\n'
+        exit 0
+        ;;
+    esac
+  done
+
+  printf '%s\n' "${selected[@]}"
+}
+
+update_gitignore() {
+  local gitignore="$PROJECT/.gitignore"
+  local -a entries=()
+  local -a missing=()
+  local header_needed=0
+  local entry
+
+  [ "${do_opencode:-0}" -eq 1 ] && entries+=(".opencode/" "OPENCODE.md")
+  [ "${do_claude:-0}" -eq 1 ] && entries+=(".claude/" "CLAUDE.md")
+  [ "${do_agents:-0}" -eq 1 ] && entries+=(".agents/" "AGENTS.md")
+  [ "${do_gemini:-0}" -eq 1 ] && entries+=("GEMINI.md")
+  [ "${do_copilot:-0}" -eq 1 ] && entries+=(".github/copilot-instructions.md")
+
+  if [ "${#entries[@]}" -eq 0 ]; then
+    printf '  .gitignore: skipped (no platform files selected)\n'
+    return
+  fi
+
+  touch "$gitignore"
+
+  if ! grep -Fqx '# @anionzo/skill' "$gitignore" 2>/dev/null; then
+    header_needed=1
+  fi
+
+  for entry in "${entries[@]}"; do
+    if ! grep -Fqx "$entry" "$gitignore" 2>/dev/null; then
+      missing+=("$entry")
+    fi
+  done
+
+  if [ "${#missing[@]}" -eq 0 ]; then
+    printf '  .gitignore: already up to date -> %s\n' "$gitignore"
+    return
+  fi
+
+  if [ "$header_needed" -eq 1 ]; then
+    printf '\n# @anionzo/skill\n' >> "$gitignore"
+  fi
+
+  for entry in "${missing[@]}"; do
+    printf '%s\n' "$entry" >> "$gitignore"
+  done
+
+  printf '  .gitignore: added %d entries -> %s\n' "${#missing[@]}" "$gitignore"
 }
 
 # --- Main ---
@@ -146,36 +324,16 @@ printf '  @anionzo/skill — AI Skill Library\n'
 printf '  ==================================\n\n'
 
 if is_interactive; then
-  # --- Interactive: let user pick platforms ---
-
-  printf '  Which platforms do you want to install?\n\n'
-  printf '  [1] OpenCode        (.opencode/skills/ + OPENCODE.md)\n'
-  printf '  [2] Claude Code     (.claude/skills/   + CLAUDE.md)\n'
-  printf '  [3] Agents (generic)(.agents/skills/   + AGENTS.md)\n'
-  printf '  [4] Gemini CLI      (GEMINI.md)\n'
-  printf '  [5] GitHub Copilot  (.github/copilot-instructions.md)\n'
-  printf '  [a] All of the above\n\n'
-
-  printf '  Enter choices (e.g. 1 2 3, or a for all): '
-  read -r choices
-
-  # Normalize
-  case "$choices" in
-    *[aA]*) choices="1 2 3 4 5" ;;
-  esac
-
-  # Parse choices into flags
-  do_opencode=0; do_claude=0; do_agents=0; do_gemini=0; do_copilot=0
-
-  for c in $choices; do
-    case "$c" in
-      1) do_opencode=1 ;;
-      2) do_claude=1 ;;
-      3) do_agents=1 ;;
-      4) do_gemini=1 ;;
-      5) do_copilot=1 ;;
-    esac
-  done
+  # --- Interactive: let user pick platforms with arrows + space ---
+
+  mapfile -t selected < <(interactive_select)
+
+  do_opencode=${selected[0]}
+  do_claude=${selected[1]}
+  do_agents=${selected[2]}
+  do_gemini=${selected[3]}
+  do_copilot=${selected[4]}
+  do_gitignore=${selected[5]}
 
   # Check if anything was selected
   total=$((do_opencode + do_claude + do_agents + do_gemini + do_copilot))
@@ -213,6 +371,10 @@ if is_interactive; then
     printf '  -> .github/copilot-instructions.md\n'
   fi
 
+  if [ "$do_gitignore" -eq 1 ]; then
+    update_gitignore
+  fi
+
 else
   # --- Silent mode: postinstall — install all skill dirs, no agent files ---
 

package/skills/brainstorming/SKILL.md

@@ -175,9 +175,9 @@ Present results using the Shared Output Contract:
    - acceptance criteria (if spec written)
    - open questions
 3. **Next Action** — after approval:
-   - to review each step: `planning` (with spec reference)
-   - to execute everything at once: `go-pipeline` (with spec reference)
-   - if requirements still unclear: state what decision is still needed
+    - to review each step: `planning` (with spec reference)
+    - to execute everything at once: `planning` in go mode (with spec reference)
+    - if requirements still unclear: state what decision is still needed
 
 ## Red Flags
 

package/skills/brainstorming/meta.yaml

@@ -28,5 +28,4 @@ related_skills:
   - using-skills
   - planning
   - research
-  - go-pipeline
   - feature-delivery