@anionzo/skill 1.3.0 → 1.4.0

package/README.md

@@ -126,11 +126,18 @@ bash scripts/sync-platform-files
 
 > Available on [npm](https://www.npmjs.com/package/@anionzo/skill) — no authentication required
 
+```bash
+# Recommended: one command, no package.json created
+npx @anionzo/skill
+```
+
+Or add as a project dependency (creates package.json):
+
 ```bash
 npm install @anionzo/skill
 ```
 
-That's it! Skills are automatically installed into:
+Skills are automatically installed into:
 
 - `.opencode/skills/` — for OpenCode
 - `.claude/skills/` — for Claude Code

package/i18n/README.vi.md

@@ -124,11 +124,18 @@ bash scripts/sync-platform-files
 
 > Có sẵn trên [npm](https://www.npmjs.com/package/@anionzo/skill) — không cần xác thực
 
+```bash
+# Khuyên dùng: một lệnh, không tạo package.json
+npx @anionzo/skill
+```
+
+Hoặc thêm như dependency của project (tạo package.json):
+
 ```bash
 npm install @anionzo/skill
 ```
 
-Xong! Skill tự động được cài vào:
+Skill tự động được cài vào:
 
 - `.opencode/skills/` — cho OpenCode
 - `.claude/skills/` — cho Claude Code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anionzo/skill",
-  "version": "1.3.0",
+  "version": "1.4.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,11 +1,13 @@
 #!/usr/bin/env sh
 
-# Install skills into .opencode/skills/ with proper YAML frontmatter
+# Install AI skills into agent-specific directories
 #
-# Auto-runs on npm install (postinstall hook).
-# Also supports: .claude/skills/ and .agents/skills/
+# Interactive mode (npx): shows menu to pick platforms
+# Silent mode (postinstall): installs all platforms automatically
 #
-# Manual usage:
+# Usage:
+#   npx @anionzo/skill              # interactive
+#   npm install @anionzo/skill      # auto (postinstall)
 #   bash scripts/install-opencode-skills [project-dir]
 
 set -eu
@@ -27,6 +29,8 @@ case "$PROJECT" in
   */node_modules/*) exit 0 ;;
 esac
 
+# --- Skill installer ---
+
 install_skills() {
   target_dir="$1"
   format_name="$2"
@@ -63,15 +67,160 @@ install_skills() {
   printf '  %s: %d skills -> %s\n' "$format_name" "$count" "$target_dir"
 }
 
-printf '\n@anionzo/skill: installing skills...\n'
+# --- Agent instruction file generator ---
+
+build_catalog() {
+  catalog=""
+  for meta in "$ROOT"/skills/*/meta.yaml; do
+    [ -f "$meta" ] || continue
+    name=$(sed -n 's/^name:[[:space:]]*//p' "$meta" | sed -n '1p')
+    summary=$(sed -n 's/^summary:[[:space:]]*//p' "$meta" | sed -n '1p')
+    catalog="$catalog$name|$summary
+"
+  done
+  printf '%s' "$catalog"
+}
+
+write_agent_file() {
+  title=$1
+  target=$2
+  catalog=$3
+
+  {
+    printf '<!-- Generated by @anionzo/skill -->\n'
+    printf '# %s\n\n' "$title"
+    printf 'Start with `skills/using-skills/SKILL.md` when the task shape is unclear. Use one primary skill at a time, then pull in the smallest amount of supporting knowledge needed.\n\n'
+
+    printf '## Core Files\n\n'
+    printf -- '- `skills/using-skills/SKILL.md`\n'
+    printf -- '- `knowledge/global/engineering-principles.md`\n'
+    printf -- '- `knowledge/global/review-heuristics.md`\n'
+    printf -- '- `knowledge/global/debugging-patterns.md`\n'
+    printf -- '- `knowledge/global/evidence-before-claims.md`\n'
+    printf -- '- `knowledge/global/skill-triggering-rules.md`\n'
+    printf -- '- `docs/skill-spec.md`\n\n'
+
+    printf '## Working Rules\n\n'
+    printf -- '- Prefer the smallest correct change.\n'
+    printf -- '- Read the repo and nearby patterns before editing.\n'
+    printf -- '- Ask only the shortest blocking question when a decision is missing.\n'
+    printf -- '- Verify important claims with code, tests, or commands when possible.\n'
+    printf -- '- Keep summaries concise and grounded in files you inspected.\n\n'
+
+    printf '## Skill Catalog\n\n'
+    printf '%s' "$catalog" | while IFS='|' read -r name summary; do
+      [ -n "$name" ] || continue
+      printf -- '- `%s`: %s\n' "$name" "$summary"
+    done
+
+    printf '\n## Suggested Flow\n\n'
+    printf '1. Route with `using-skills` when unsure.\n'
+    printf '2. Load one primary skill that matches the current task.\n'
+    printf '3. Pull in `knowledge/project/` notes when working inside a real project.\n'
+    printf '4. Verify the outcome before declaring the work complete.\n'
+  } > "$target"
+}
+
+# --- Platform definitions ---
+
+# Each platform: skill_dir | agent_file | agent_title | display_name
+PLATFORMS="
+opencode|.opencode/skills|OPENCODE.md|OpenCode Instructions|OpenCode
+claude|.claude/skills|CLAUDE.md|Claude Code Instructions|Claude Code
+agents|.agents/skills|AGENTS.md|Generic Agent Instructions|Agents (generic)
+gemini||GEMINI.md|Gemini Instructions|Gemini CLI
+copilot||.github/copilot-instructions.md|GitHub Copilot Instructions|GitHub Copilot
+"
+
+# --- Interactive mode detection ---
+
+is_interactive() {
+  # postinstall (npm) sets INIT_CWD — skip interactive
+  [ -z "${INIT_CWD:-}" ] && [ -t 0 ]
+}
+
+# --- Main ---
+
+printf '\n'
+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
+
+  # Check if anything was selected
+  total=$((do_opencode + do_claude + do_agents + do_gemini + do_copilot))
+  if [ "$total" -eq 0 ]; then
+    printf '\n  Nothing selected. Exiting.\n\n'
+    exit 0
+  fi
+
+  catalog=$(build_catalog)
+
+  printf '\n  Installing...\n\n'
+
+  if [ "$do_opencode" -eq 1 ]; then
+    install_skills "$PROJECT/.opencode/skills" "OpenCode"
+    write_agent_file "OpenCode Instructions" "$PROJECT/OPENCODE.md" "$catalog"
+    printf '  -> OPENCODE.md\n'
+  fi
+  if [ "$do_claude" -eq 1 ]; then
+    install_skills "$PROJECT/.claude/skills" "Claude"
+    write_agent_file "Claude Code Instructions" "$PROJECT/CLAUDE.md" "$catalog"
+    printf '  -> CLAUDE.md\n'
+  fi
+  if [ "$do_agents" -eq 1 ]; then
+    install_skills "$PROJECT/.agents/skills" "Agents"
+    write_agent_file "Generic Agent Instructions" "$PROJECT/AGENTS.md" "$catalog"
+    printf '  -> AGENTS.md\n'
+  fi
+  if [ "$do_gemini" -eq 1 ]; then
+    write_agent_file "Gemini Instructions" "$PROJECT/GEMINI.md" "$catalog"
+    printf '  -> GEMINI.md\n'
+  fi
+  if [ "$do_copilot" -eq 1 ]; then
+    mkdir -p "$PROJECT/.github"
+    write_agent_file "GitHub Copilot Instructions" "$PROJECT/.github/copilot-instructions.md" "$catalog"
+    printf '  -> .github/copilot-instructions.md\n'
+  fi
 
-# OpenCode: .opencode/skills/
-install_skills "$PROJECT/.opencode/skills" "OpenCode"
+else
+  # --- Silent mode: postinstall — install all skill dirs, no agent files ---
 
-# Claude Code: .claude/skills/
-install_skills "$PROJECT/.claude/skills" "Claude"
+  printf '  Installing skills (postinstall)...\n\n'
 
-# Generic agents: .agents/skills/
-install_skills "$PROJECT/.agents/skills" "Agents"
+  install_skills "$PROJECT/.opencode/skills" "OpenCode"
+  install_skills "$PROJECT/.claude/skills" "Claude"
+  install_skills "$PROJECT/.agents/skills" "Agents"
+fi
 
-printf '\nDone! Skills are ready. Use /skill in OpenCode or Claude Code.\n\n'
+printf '\n  Done! Use /skill in your agent to see available skills.\n\n'