repo-nexus 0.7.6 → 0.7.8

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to Repo Nexus (`rnex`) will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.7] - 2026-10-15
+
+### Added
+- **Native `SKILL.md` Bundle Support for User Skills**:
+  - Upgraded User Skill generator (`rnex_register_user_skill`) to emit dual formats tailored to each AI provider's discovery engine:
+    - **Skill-Based Providers (`.github/skills/`, `.claude/skills/`, `.gemini/skills/`)**: Generates native `rnex-<name>/SKILL.md` directory bundles containing YAML frontmatter (`name: rnex-<name>`, `description: "..."`) for automatic discoverability in VS Code, Copilot Chat, Antigravity, and Claude Code skill-pickers.
+    - **Rule-Based Providers (`.cursor/rules/`, `.windsurf/rules/`)**: Generates flat `rnex-<name>.md` pointer files aligning with Cursor and Windsurf rule conventions.
+  - Automatically extracts skill descriptions from target markdown headers to populate YAML frontmatter cleanly.
+- **GitHub Copilot Integration Plugin (`copilot`)**:
+  - Restored `copilot` as a first-class AI provider plugin in `toolkit/plugins/copilot/`.
+  - Supports `instructions: true` (managing `.github/copilot-instructions.md` within non-destructive delimiters) and `skills: true` (generating native User Skill bundles in `.github/skills/`).
+  - Added CLI flags `--copilot` and `--no-copilot` to `rnex init`.
+
 ## [0.7.5] - 2026-10-15
 
 ### Added

package/docs/CLI.md

@@ -87,8 +87,8 @@ Every lifecycle hook receives the following environment variables:
 | `RNEX_QUIET` | Set to `1` when `--quiet` was passed, `0` otherwise. |
 
 Hooks have access to POSIX helper functions for managing User Skill pointers:
-- `rnex_register_user_skill <skill_name> <target_path_in_rnex>`: Generates a zero-logic user skill pointer (`rnex-<skill_name>.md`) in active provider directories linking to the target skill protocol.
-- `rnex_unregister_user_skill <skill_name>`: Removes the `rnex-<skill_name>.md` user skill pointer from all active provider directories.
+- `rnex_register_user_skill <skill_name> <target_path_in_rnex>`: Generates a zero-logic user skill pointer (either a native `rnex-<name>/SKILL.md` bundle with YAML frontmatter for skill-based providers, or a flat `rnex-<name>.md` file for rule-based providers) linking to the target skill protocol.
+- `rnex_unregister_user_skill <skill_name>`: Removes the `rnex-<skill_name>` user skill pointer (bundle or flat file) from all active provider directories.
 
 ### Karpathy LLM Wiki Plugin
 The `karpathy-llm` plugin uses lifecycle hooks to manage its domain directories:

package/docs/plugins/claude.md

@@ -15,8 +15,8 @@ Operational skills, rules, and subagents remain cleanly encapsulated within `.rn
 
 ## Capabilities
 
-1. **Zero-Logic User Skills (`.claude/skills/rnex-*.md`)**:
-   - Generates lightweight user skill pointers prefixed with `rnex-` in `.claude/skills/`.
+1. **Zero-Logic User Skills (`.claude/skills/rnex-*/SKILL.md`)**:
+   - Generates native `SKILL.md` bundles prefixed with `rnex-` in `.claude/skills/` with YAML frontmatter for Claude Code skill discovery.
    - Contains zero inline heuristics—redirects Claude directly to the underlying agentic skill protocols inside `.rnex/`.
 
 2. **Native Instruction Support via `CLAUDE.md` & `AGENTS.md`**:

package/docs/plugins/copilot.md

@@ -0,0 +1,47 @@
+---
+title: GitHub Copilot Plugin
+description: GitHub Copilot workspace routing instructions and user skill integration for Repo Nexus.
+---
+
+# GitHub Copilot Plugin (`copilot`)
+
+The `copilot` plugin integrates GitHub Copilot with Repo Nexus by projecting workspace routing instructions into `.github/copilot-instructions.md` and user skills into `.github/skills/`.
+
+## Architecture & Integration
+
+GitHub Copilot operates natively within VS Code, Visual Studio, JetBrains, and GitHub.com:
+- **Universal Routing (`AGENTS.md`)**: GitHub Copilot natively reads `AGENTS.md` at the workspace root.
+- **Custom Instructions (`.github/copilot-instructions.md`)**: When `instructions: true`, Repo Nexus injects its non-destructive routing block inside `<!-- REPO-NEXUS:START -->` and `<!-- REPO-NEXUS:END -->`. Custom developer rules outside these markers are strictly preserved.
+- **User Skills (`.github/skills/`)**: When `skills: true`, Repo Nexus generates native `SKILL.md` directory bundles (`.github/skills/rnex-<name>/SKILL.md`) with YAML frontmatter, making them automatically discoverable in VS Code and Copilot Chat skill-pickers while redirecting to the underlying agentic skills under `.rnex/skills/` and active plugins.
+
+## Configuration
+
+Enable in `rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    instructions: true   # Maintain routing in .github/copilot-instructions.md
+    skills: true         # Generate user skills in .github/skills/
+```
+
+To disable locally without altering team configuration, add to `.local.rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    enabled: false
+```
+
+## CLI Management
+
+```bash
+# Enable Copilot plugin across workspace
+rnex plugin enable copilot
+
+# Inspect Copilot plugin status
+rnex plugin info copilot
+
+# Disable Copilot plugin
+rnex plugin disable copilot
+```

package/docs/plugins/gemini.md

@@ -15,8 +15,8 @@ Operational skills, rules, and subagents remain cleanly encapsulated within `.rn
 
 ## Capabilities
 
-1. **Zero-Logic User Skills (`.gemini/skills/rnex-*.md`)**:
-   - Generates lightweight user skill pointers prefixed with `rnex-` in `.gemini/skills/`.
+1. **Zero-Logic User Skills (`.gemini/skills/rnex-*/SKILL.md`)**:
+   - Generates native `SKILL.md` bundles prefixed with `rnex-` in `.gemini/skills/` with YAML frontmatter for Gemini and Antigravity skill discovery.
    - Contains zero inline heuristics—redirects Gemini/Antigravity directly to the underlying agentic skill protocols inside `.rnex/`.
 
 2. **Native Instructions Support via `GEMINI.md`**:

package/docs/plugins/index.md

@@ -23,7 +23,7 @@ Active plugins are mirrored into each active member repository under `repos/<nam
 Repo Nexus decouples functional plugins from AI provider plugins:
 - **Core Skills (`toolkit/skills/` $\rightarrow$ `.rnex/skills/`)**: Workspace-level capabilities owned by Repo Nexus core.
 - **Plugin Skills (`toolkit/plugins/<plugin>/skills/` $\rightarrow$ `.rnex/plugins/<plugin>/skills/`)**: Scoped domain skills owned exclusively by individual plugins.
-- **User Skills (`rnex-<name>.md`)**: Provider plugins (`claude`, `gemini`, `cursor`, and `windsurf`) generate zero-logic user skill pointers in active provider directories (`.cursor/rules/`, `.claude/skills/`, `.gemini/skills/`, `.windsurf/rules/`) that redirect AI assistants directly to the underlying agentic skills in `.rnex/`.
+- **User Skills**: Provider plugins (`copilot`, `claude`, `gemini`, `cursor`, and `windsurf`) project zero-logic user skill pointers into active provider directories using native `SKILL.md` bundles with YAML frontmatter in skill directories (`.github/skills/`, `.claude/skills/`, `.gemini/skills/`) and flat files in rule directories (`.cursor/rules/`, `.windsurf/rules/`), redirecting AI assistants directly to the underlying agentic skills in `.rnex/`.
 
 ### 4. Non-Destructive Delimited Merging
 When plugins update root instruction files (`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`), Repo Nexus isolates auto-managed routing between explicit delimiters:

package/lib/ai.sh

@@ -359,6 +359,7 @@ export RNEX_ROOT="${RNEX_ROOT:-$(cd "$(dirname "$0")/../.." 2>/dev/null && pwd -
 
 if [ -z "$RNEX_PROVIDER_SKILL_DIRS" ]; then
   _dirs=""
+  [ -d "$RNEX_ROOT/.github/skills" ] && _dirs="${_dirs:+$_dirs }.github/skills"
   [ -d "$RNEX_ROOT/.cursor" ] && _dirs="${_dirs:+$_dirs }.cursor/rules"
   [ -d "$RNEX_ROOT/.claude" ] && _dirs="${_dirs:+$_dirs }.claude/skills"
   [ -d "$RNEX_ROOT/.windsurf" ] && _dirs="${_dirs:+$_dirs }.windsurf/rules"
@@ -369,21 +370,63 @@ fi
 rnex_register_user_skill() {
   skill_name="$1"
   target_path="$2"
-  for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
-    mkdir -p "$RNEX_ROOT/$provider_dir"
-    cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+  _dirs="${RNEX_PROVIDER_SKILL_DIRS:-}"
+  _r="${RNEX_ROOT:-.}"
+
+  _target_file=""
+  if [ -f "$_r/$target_path" ]; then
+    _target_file="$_r/$target_path"
+  elif [ -f "$target_path" ]; then
+    _target_file="$target_path"
+  fi
+
+  _skill_desc=""
+  if [ -n "$_target_file" ]; then
+    _skill_desc="$(awk 'NF && !/^#/ { print; exit }' "$_target_file" 2>/dev/null)"
+  fi
+  if [ -z "$_skill_desc" ]; then
+    _skill_desc="Repo Nexus agentic skill protocol for ${skill_name}."
+  fi
+  _skill_desc="$(printf '%s' "$_skill_desc" | tr '\n\r' '  ' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//;s/"/\\"/g')"
+
+  for provider_dir in $_dirs; do
+    case "$provider_dir" in
+      *rules*)
+        mkdir -p "$_r/$provider_dir"
+        rm -rf "$_r/$provider_dir/rnex-${skill_name}" 2>/dev/null || true
+        cat << EOF > "$_r/$provider_dir/rnex-${skill_name}.md"
 # User Skill: rnex-${skill_name}
 
 CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
 \`${target_path}\`
 EOF
+        ;;
+      *)
+        mkdir -p "$_r/$provider_dir/rnex-${skill_name}"
+        rm -f "$_r/$provider_dir/rnex-${skill_name}.md" 2>/dev/null || true
+        cat << EOF > "$_r/$provider_dir/rnex-${skill_name}/SKILL.md"
+---
+name: rnex-${skill_name}
+description: "${_skill_desc}"
+---
+
+# User Skill: rnex-${skill_name}
+
+CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
+\`${target_path}\`
+EOF
+        ;;
+    esac
   done
 }
 
 rnex_unregister_user_skill() {
   skill_name="$1"
-  for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
-    rm -f "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+  _dirs="${RNEX_PROVIDER_SKILL_DIRS:-}"
+  _r="${RNEX_ROOT:-.}"
+  for provider_dir in $_dirs; do
+    rm -f "$_r/$provider_dir/rnex-${skill_name}.md"
+    rm -rf "$_r/$provider_dir/rnex-${skill_name}"
   done
 }
 ENV_EOF
@@ -392,6 +435,9 @@ ENV_EOF
 
 get_active_provider_skill_dirs() {
   _dirs=""
+  if provider_option_enabled "copilot" "skills" 2>/dev/null; then
+    _dirs="${_dirs:+$_dirs }.github/skills"
+  fi
   if provider_option_enabled "cursor" "skills" 2>/dev/null; then
     _dirs="${_dirs:+$_dirs }.cursor/rules"
   fi
@@ -413,14 +459,51 @@ rnex_register_user_skill() {
   target_path="$2"
   _dirs="${RNEX_PROVIDER_SKILL_DIRS:-$(get_active_provider_skill_dirs)}"
   _r="${NEXUS_DIR:-${RNEX_ROOT:-.}}"
+
+  _target_file=""
+  if [ -f "$_r/$target_path" ]; then
+    _target_file="$_r/$target_path"
+  elif [ -f "$target_path" ]; then
+    _target_file="$target_path"
+  fi
+
+  _skill_desc=""
+  if [ -n "$_target_file" ]; then
+    _skill_desc="$(awk 'NF && !/^#/ { print; exit }' "$_target_file" 2>/dev/null)"
+  fi
+  if [ -z "$_skill_desc" ]; then
+    _skill_desc="Repo Nexus agentic skill protocol for ${skill_name}."
+  fi
+  _skill_desc="$(printf '%s' "$_skill_desc" | tr '\n\r' '  ' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//;s/"/\\"/g')"
+
   for provider_dir in $_dirs; do
-    mkdir -p "$_r/$provider_dir"
-    cat << EOF > "$_r/$provider_dir/rnex-${skill_name}.md"
+    case "$provider_dir" in
+      *rules*)
+        mkdir -p "$_r/$provider_dir"
+        rm -rf "$_r/$provider_dir/rnex-${skill_name}" 2>/dev/null || true
+        cat << EOF > "$_r/$provider_dir/rnex-${skill_name}.md"
 # User Skill: rnex-${skill_name}
 
 CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
 \`${target_path}\`
 EOF
+        ;;
+      *)
+        mkdir -p "$_r/$provider_dir/rnex-${skill_name}"
+        rm -f "$_r/$provider_dir/rnex-${skill_name}.md" 2>/dev/null || true
+        cat << EOF > "$_r/$provider_dir/rnex-${skill_name}/SKILL.md"
+---
+name: rnex-${skill_name}
+description: "${_skill_desc}"
+---
+
+# User Skill: rnex-${skill_name}
+
+CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
+\`${target_path}\`
+EOF
+        ;;
+    esac
   done
 }
 
@@ -431,6 +514,7 @@ rnex_unregister_user_skill() {
   _r="${NEXUS_DIR:-${RNEX_ROOT:-.}}"
   for provider_dir in $_dirs; do
     rm -f "$_r/$provider_dir/rnex-${skill_name}.md"
+    rm -rf "$_r/$provider_dir/rnex-${skill_name}"
   done
 }
 
@@ -440,8 +524,7 @@ clean_provider_user_skills() {
   rm -f "$_sk_dir"/rnex-*.md 2>/dev/null || true
   for _d in "$_sk_dir"/rnex-*; do
     [ -d "$_d" ] || continue
-    rm -f "$_d/SKILL.md" 2>/dev/null || true
-    rmdir "$_d" 2>/dev/null || true
+    rm -rf "$_d" 2>/dev/null || true
   done
   rmdir "$_sk_dir" 2>/dev/null || true
 }
@@ -671,13 +754,28 @@ sync_windsurf() {
   rmdir "$NEXUS_DIR/.windsurf" 2>/dev/null || true
 }
 
-sync_ai_providers() {
-  # Clean legacy Copilot prompt harness and skills if present, strictly preserving custom Copilot instructions
-  rm -rf "$NEXUS_DIR/.github/prompts" 2>/dev/null || true
-  clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
-  clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+sync_copilot() {
+  if copilot_plugin_enabled; then
+    if copilot_instructions_enabled; then
+      mkdir -p "$NEXUS_DIR/.github"
+      merge_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    else
+      clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    fi
+    if ! copilot_skills_enabled; then
+      clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+    fi
+  else
+    clean_rnex_instructions "$NEXUS_DIR/.github/copilot-instructions.md"
+    clean_provider_user_skills "$NEXUS_DIR/.github/skills"
+  fi
   clean_provider_agents "$NEXUS_DIR/.github/agents" ".agent.md"
+  rm -rf "$NEXUS_DIR/.github/prompts" 2>/dev/null || true
+  rmdir "$NEXUS_DIR/.github" 2>/dev/null || true
+}
 
+sync_ai_providers() {
+  sync_copilot
   sync_claude
   sync_gemini
   sync_cursor

package/lib/commands/init.sh

@@ -21,7 +21,8 @@ cmd_init() {
       -y|--yes) _non_interactive=1 ;;
       --hooks) _cli_hooks="true" ;;
       --no-hooks) _cli_no_hooks=1; _cli_hooks="false" ;;
-      --copilot|--no-copilot) ;; # Legacy flag ignored
+      --copilot) _cli_copilot="true" ;;
+      --no-copilot) _cli_copilot="false" ;;
       --claude) _cli_claude="true" ;;
       --no-claude) _cli_claude="false" ;;
       --gemini) _cli_gemini="true" ;;
@@ -102,6 +103,9 @@ cmd_init() {
     log_dim "  rnex sync"
   else
     _init_plugins=""
+    if [ "$_cli_copilot" = "true" ]; then
+      _init_plugins="${_init_plugins}  copilot:\n    instructions: true\n    skills: true\n"
+    fi
     if [ "$_cli_claude" = "true" ]; then
       _init_plugins="${_init_plugins}  claude:\n    instructions: true\n    skills: true\n"
     fi
@@ -149,6 +153,7 @@ YAML_EOF
   [ -f "$_init_dir/GEMINI.md" ] && merge_rnex_instructions "$_init_dir/GEMINI.md"
   [ -f "$_init_dir/.cursorrules" ] && merge_rnex_instructions "$_init_dir/.cursorrules"
   [ -f "$_init_dir/.windsurfrules" ] && merge_rnex_instructions "$_init_dir/.windsurfrules"
+  [ -f "$_init_dir/.github/copilot-instructions.md" ] && merge_rnex_instructions "$_init_dir/.github/copilot-instructions.md"
 
   # ---- 3. Create repos directory with .gitkeep -----------------------------
   _repos_dir="$_init_dir/repos"

package/lib/commands/status.sh

@@ -165,15 +165,18 @@ cmd_status() {
   if [ -d "$NEXUS_DIR/.cursor/rules" ] && ls "$NEXUS_DIR/.cursor/rules"/rnex-*.md >/dev/null 2>&1; then
     printf '  %b✓%b %s %b(Cursor user skills)%b\n' "$_G" "$_NC" ".cursor/rules/" "$_DIM" "$_NC"
   fi
-  if [ -d "$NEXUS_DIR/.claude/skills" ] && ls "$NEXUS_DIR/.claude/skills"/rnex-*.md >/dev/null 2>&1; then
+  if [ -d "$NEXUS_DIR/.claude/skills" ] && { ls "$NEXUS_DIR/.claude/skills"/rnex-*.md >/dev/null 2>&1 || ls -d "$NEXUS_DIR/.claude/skills"/rnex-* >/dev/null 2>&1; }; then
     printf '  %b✓%b %s %b(Claude user skills)%b\n' "$_G" "$_NC" ".claude/skills/" "$_DIM" "$_NC"
   fi
   if [ -d "$NEXUS_DIR/.windsurf/rules" ] && ls "$NEXUS_DIR/.windsurf/rules"/rnex-*.md >/dev/null 2>&1; then
     printf '  %b✓%b %s %b(Windsurf user skills)%b\n' "$_G" "$_NC" ".windsurf/rules/" "$_DIM" "$_NC"
   fi
-  if [ -d "$NEXUS_DIR/.gemini/skills" ] && ls "$NEXUS_DIR/.gemini/skills"/rnex-*.md >/dev/null 2>&1; then
+  if [ -d "$NEXUS_DIR/.gemini/skills" ] && { ls "$NEXUS_DIR/.gemini/skills"/rnex-*.md >/dev/null 2>&1 || ls -d "$NEXUS_DIR/.gemini/skills"/rnex-* >/dev/null 2>&1; }; then
     printf '  %b✓%b %s %b(Gemini user skills)%b\n' "$_G" "$_NC" ".gemini/skills/" "$_DIM" "$_NC"
   fi
+  if [ -d "$NEXUS_DIR/.github/skills" ] && { ls "$NEXUS_DIR/.github/skills"/rnex-*.md >/dev/null 2>&1 || ls -d "$NEXUS_DIR/.github/skills"/rnex-* >/dev/null 2>&1; }; then
+    printf '  %b✓%b %s %b(Copilot user skills)%b\n' "$_G" "$_NC" ".github/skills/" "$_DIM" "$_NC"
+  fi
   printf '\n'
 
   printf '%bActive Plugins:%b\n' "$_BOLD" "$_NC"

package/lib/hooks.sh

@@ -62,14 +62,49 @@ run_hook() {
         rnex_register_user_skill() {
           skill_name="$1"
           target_path="$2"
+          _target_file=""
+          if [ -f "$RNEX_ROOT/$target_path" ]; then
+            _target_file="$RNEX_ROOT/$target_path"
+          elif [ -f "$target_path" ]; then
+            _target_file="$target_path"
+          fi
+          _skill_desc=""
+          if [ -n "$_target_file" ]; then
+            _skill_desc="$(awk 'NF && !/^#/ { print; exit }' "$_target_file" 2>/dev/null)"
+          fi
+          if [ -z "$_skill_desc" ]; then
+            _skill_desc="Repo Nexus agentic skill protocol for ${skill_name}."
+          fi
+          _skill_desc="$(printf '%s' "$_skill_desc" | tr '\n\r' '  ' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//;s/"/\\"/g')"
+
           for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
-            mkdir -p "$RNEX_ROOT/$provider_dir"
-            cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+            case "$provider_dir" in
+              *rules*)
+                mkdir -p "$RNEX_ROOT/$provider_dir"
+                rm -rf "$RNEX_ROOT/$provider_dir/rnex-${skill_name}" 2>/dev/null || true
+                cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+# User Skill: rnex-${skill_name}
+
+CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
+\`${target_path}\`
+EOF
+                ;;
+              *)
+                mkdir -p "$RNEX_ROOT/$provider_dir/rnex-${skill_name}"
+                rm -f "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md" 2>/dev/null || true
+                cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}/SKILL.md"
+---
+name: rnex-${skill_name}
+description: "${_skill_desc}"
+---
+
 # User Skill: rnex-${skill_name}
 
 CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
 \`${target_path}\`
 EOF
+                ;;
+            esac
           done
         }
 
@@ -78,6 +113,7 @@ EOF
           skill_name="$1"
           for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
             rm -f "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+            rm -rf "$RNEX_ROOT/$provider_dir/rnex-${skill_name}"
           done
         }
         set -- "$@"
@@ -141,14 +177,49 @@ run_plugin_hook() {
       rnex_register_user_skill() {
         skill_name="$1"
         target_path="$2"
+        _target_file=""
+        if [ -f "$RNEX_ROOT/$target_path" ]; then
+          _target_file="$RNEX_ROOT/$target_path"
+        elif [ -f "$target_path" ]; then
+          _target_file="$target_path"
+        fi
+        _skill_desc=""
+        if [ -n "$_target_file" ]; then
+          _skill_desc="$(awk 'NF && !/^#/ { print; exit }' "$_target_file" 2>/dev/null)"
+        fi
+        if [ -z "$_skill_desc" ]; then
+          _skill_desc="Repo Nexus agentic skill protocol for ${skill_name}."
+        fi
+        _skill_desc="$(printf '%s' "$_skill_desc" | tr '\n\r' '  ' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//;s/"/\\"/g')"
+
         for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
-          mkdir -p "$RNEX_ROOT/$provider_dir"
-          cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+          case "$provider_dir" in
+            *rules*)
+              mkdir -p "$RNEX_ROOT/$provider_dir"
+              rm -rf "$RNEX_ROOT/$provider_dir/rnex-${skill_name}" 2>/dev/null || true
+              cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+# User Skill: rnex-${skill_name}
+
+CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
+\`${target_path}\`
+EOF
+              ;;
+            *)
+              mkdir -p "$RNEX_ROOT/$provider_dir/rnex-${skill_name}"
+              rm -f "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md" 2>/dev/null || true
+              cat << EOF > "$RNEX_ROOT/$provider_dir/rnex-${skill_name}/SKILL.md"
+---
+name: rnex-${skill_name}
+description: "${_skill_desc}"
+---
+
 # User Skill: rnex-${skill_name}
 
 CRITICAL: Do not execute inline heuristics. Read and strictly follow the agentic skill protocol at:
 \`${target_path}\`
 EOF
+              ;;
+          esac
         done
       }
 
@@ -157,6 +228,7 @@ EOF
         skill_name="$1"
         for provider_dir in $RNEX_PROVIDER_SKILL_DIRS; do
           rm -f "$RNEX_ROOT/$provider_dir/rnex-${skill_name}.md"
+          rm -rf "$RNEX_ROOT/$provider_dir/rnex-${skill_name}"
         done
       }
       set -- "$@"

package/lib/yaml.sh

@@ -117,9 +117,9 @@ provider_option_enabled() {
   esac
 }
 
-copilot_plugin_enabled() { return 1; }
-copilot_skills_enabled() { return 1; }
-copilot_instructions_enabled() { return 1; }
+copilot_plugin_enabled() { provider_plugin_enabled "copilot"; }
+copilot_instructions_enabled() { provider_option_enabled "copilot" "instructions"; }
+copilot_skills_enabled() { provider_option_enabled "copilot" "skills"; }
 copilot_agents_enabled() { return 1; }
 
 claude_plugin_enabled() { provider_plugin_enabled "claude"; }
@@ -143,7 +143,7 @@ windsurf_skills_enabled() { provider_option_enabled "windsurf" "skills"; }
 windsurf_agents_enabled() { return 1; }
 
 has_ai_provider_plugin_enabled() {
-  for _ap in claude gemini cursor windsurf; do
+  for _ap in copilot claude gemini cursor windsurf; do
     if provider_plugin_enabled "$_ap"; then
       return 0
     fi
@@ -261,7 +261,7 @@ yaml_enable_plugin() {
   if ! _yaml_list_plugins_from_file "$_target_file" | grep -qx "$_name" 2>/dev/null; then
     _tmp="$(mktemp)"
     case "$_name" in
-      claude|gemini|cursor|windsurf)
+      copilot|claude|gemini|cursor|windsurf)
         awk -v name="$_name" '
           /^plugins:[ ]*$/ || /^plugins:[ ]*#/ {
             print

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-nexus",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "description": "Lightweight, zero-dependency Virtual Meta-Repo companion for multi-repo workspaces and shared AI context (no git submodules)",
   "bin": {
     "repo-nexus": "rnex",

package/toolkit/plugins/copilot/README.md

@@ -0,0 +1,31 @@
+# GitHub Copilot Plugin for Repo Nexus
+
+A built-in Repo Nexus plugin providing instructions and skill integration for GitHub Copilot.
+
+## Capabilities
+
+1. **Instructions Integration**: Generates and maintains `.github/copilot-instructions.md` with Repo Nexus routing instructions while preserving custom instructions outside delimiters.
+2. **User Skills Generation**: Standardized Repo Nexus core skills and active plugins' skills are mirrored as zero-logic User Skill pointers (`rnex-<name>.md`) in `.github/skills/`.
+
+## Usage
+
+Enable the plugin across the workspace:
+```bash
+rnex plugin enable copilot
+```
+
+Or configure options in `rnex.yaml` or `.local.rnex.yaml`:
+```yaml
+plugins:
+  copilot:
+    instructions: true
+    skills: true
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `instructions` | boolean | `true` | Maintain routing in `.github/copilot-instructions.md` |
+| `skills` | boolean | `true` | Generate user skills in `.github/skills/` |
+| `enabled` | boolean | `true` | Set to `false` in `.local.rnex.yaml` to override team config |

package/toolkit/plugins/copilot/instructions/rnex-copilot-integration.md

@@ -0,0 +1,24 @@
+# GitHub Copilot Integration for Repo Nexus
+
+This workspace has the Repo Nexus `copilot` plugin enabled.
+
+## Operating Principles
+- **Instructions Integration**: GitHub Copilot natively reads `.github/copilot-instructions.md` and root `AGENTS.md` for workspace routing and active plugin guidelines between `<!-- REPO-NEXUS:START -->` and `<!-- REPO-NEXUS:END -->`. Custom instructions outside these markers are strictly preserved.
+- **User Skills**: Standardized Repo Nexus core skills and active plugin skills can be accessed via `.github/skills/rnex-*.md` when `skills: true`.
+
+## Configuration
+Configure plugin options in `rnex.yaml` or override them per developer in `.local.rnex.yaml`:
+
+```yaml
+plugins:
+  copilot:
+    instructions: true   # Maintain routing in .github/copilot-instructions.md (default: true)
+    skills: true         # Generate user skills in .github/skills/ (default: true)
+```
+
+To disable locally without altering team configuration, add to `.local.rnex.yaml`:
+```yaml
+plugins:
+  copilot:
+    enabled: false
+```

package/toolkit/plugins/copilot/plugin.yaml

@@ -0,0 +1,7 @@
+name: copilot
+version: 0.5.1
+description: GitHub Copilot integration (maintains .github/copilot-instructions.md and user skills in .github/skills/)
+author: unoxen
+homepage: https://github.com/unoxen/repo-nexus
+instructions:
+  - instructions/rnex-copilot-integration.md: .rnex/plugins/copilot/instructions/rnex-copilot-integration.md