Update maintainer context and state

Author: numman-ali

.github/maintainer/context.md

@@ -4,25 +4,26 @@
 OpenSkills is a universal skills loader for AI coding agents. It enables installing and managing Anthropic SKILL.md format skills across any AI agent (Claude Code, Cursor, Windsurf, Gemini, etc.), making it easy to extend agent capabilities with reusable skill definitions.
 
 ## Current Priorities
-1. **Fix Windows compatibility** - Critical bug blocking ALL Windows users from installing skills
-2. **Fix version mismatch** - CLI reports 1.2.1 when package.json is 1.3.0
-3. **Consolidate duplicate issues** - 7 issues report the same Windows bug
-4. **Review and respond to feature requests** - Growing backlog of enhancements
+1. **Close the loop on v1.5.0 fixes** - Ensure update workflow + Gemini usage change are confirmed and closed
+2. **Resolve PR backlog** - Decide on symlink installs, safe deletion, spinner changes, Nix flake
+3. **Improve onboarding docs** - Keep update guidance and agent-specific instructions clear
+4. **Triage feature requests** - Consolidate duplicates and keep the queue actionable
 
 ## Success Metrics
-- Windows users can successfully install skills
-- Version command shows correct package version
+- Update command works for typical git installs, with clear recovery steps
+- Agent usage text avoids shell/tooling misunderstandings
+- PR backlog stays small and decisions are explicit
 - Issue queue is triaged and duplicates consolidated
 - Contributors receive timely, respectful responses
 
 ## Areas
 
 | Area | Status | Notes |
 |------|--------|-------|
-| `src/commands/install.ts` | **Broken on Windows** | Path security check uses hardcoded `/` |
-| `src/cli.ts` | Needs fix | Hardcoded version `1.2.1` |
-| `tests/` | Good | 90 tests passing |
-| `docs/` | Needs work | README could use more examples |
+| `src/commands/install.ts` | Healthy | Windows path handling fixed |
+| `src/cli.ts` | Healthy | Version now reads from package.json |
+| `tests/` | Good | 103 tests passing |
+| `docs/` | Improving | Update guidance and agent usage tips added |
 
 ## Contribution Guidelines
 - PRs are reviewed for intent and approach but implemented by maintainers

.github/maintainer/index/graph.json

@@ -1,13 +1,6 @@
 {
-  "generatedAt": "2026-01-17T19:10:52.058Z",
+  "generatedAt": "2026-01-17T19:26:09.772Z",
   "nodes": [
-    {
-      "id": "issue:9",
-      "type": "issue",
-      "title": "[FEATURE] Document workflow/create script for updating skills from upstream git repo",
-      "priorityScore": 17,
-      "actionability": "needs-info"
-    },
     {
       "id": "issue:35",
       "type": "issue",
@@ -22,13 +15,6 @@
       "priorityScore": 7,
       "actionability": "ready"
     },
-    {
-      "id": "issue:16",
-      "type": "issue",
-      "title": "[BUG] Bash(\"openskills read <skill-name>\") Messes Up Gemini CLI's behaviour",
-      "priorityScore": 7,
-      "actionability": "ready"
-    },
     {
       "id": "issue:47",
       "type": "issue",
@@ -105,11 +91,6 @@
     }
   ],
   "edges": [
-    {
-      "from": "issue:47",
-      "to": "issue:9",
-      "type": "possible_duplicate"
-    },
     {
       "from": "issue:47",
       "to": "issue:41",

.github/maintainer/index/items.json

@@ -1,12 +1,12 @@
 {
-  "generatedAt": "2026-01-17T19:10:52.058Z",
+  "generatedAt": "2026-01-17T19:26:09.772Z",
   "count": 32,
   "items": [
     {
       "id": 6,
       "type": "issue",
       "title": "",
-      "actionability": "closable",
+      "actionability": "done",
       "priorityScore": 17,
       "sentimentScore": 0,
       "needsInfoScore": 0,
@@ -16,13 +16,13 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-6.md",
-      "lastSeenAt": "2026-01-17T18:18:54.518Z"
+      "lastSeenAt": "2026-01-17T19:10:52.058Z"
     },
     {
       "id": 9,
       "type": "issue",
-      "title": "[FEATURE] Document workflow/create script for updating skills from upstream git repo",
-      "actionability": "needs-info",
+      "title": "",
+      "actionability": "done",
       "priorityScore": 17,
       "sentimentScore": 0,
       "needsInfoScore": 0,
@@ -32,7 +32,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-9.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:25:46Z"
     },
     {
       "id": 13,
@@ -48,13 +48,13 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-13.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 16,
       "type": "issue",
-      "title": "[BUG] Bash(\"openskills read <skill-name>\") Messes Up Gemini CLI's behaviour",
-      "actionability": "ready",
+      "title": "",
+      "actionability": "done",
       "priorityScore": 7,
       "sentimentScore": 0,
       "needsInfoScore": 0,
@@ -64,7 +64,7 @@
         "bug"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-16.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:25:46Z"
     },
     {
       "id": 17,
@@ -94,7 +94,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-19.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 20,
@@ -126,7 +126,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-24.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 28,
@@ -181,7 +181,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-32.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 34,
@@ -211,7 +211,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-35.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 41,
@@ -227,7 +227,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-41.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 42,
@@ -275,7 +275,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-47.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 48,
@@ -307,7 +307,7 @@
         "enhancement"
       ],
       "notePath": ".github/maintainer/notes/issues/000/ISSUE-50.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 51,
@@ -403,7 +403,7 @@
       "linkedIssues": [],
       "labels": [],
       "notePath": ".github/maintainer/notes/prs/000/PR-25.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 26,
@@ -481,7 +481,7 @@
       "linkedIssues": [],
       "labels": [],
       "notePath": ".github/maintainer/notes/prs/000/PR-30.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 31,
@@ -507,7 +507,7 @@
       "linkedIssues": [],
       "labels": [],
       "notePath": ".github/maintainer/notes/prs/000/PR-31.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 37,
@@ -593,7 +593,7 @@
       "linkedIssues": [],
       "labels": [],
       "notePath": ".github/maintainer/notes/prs/000/PR-39.md",
-      "lastSeenAt": "2026-01-17T19:10:52.058Z"
+      "lastSeenAt": "2026-01-17T19:26:09.772Z"
     },
     {
       "id": 40,
@@ -625,7 +625,7 @@
       "id": 49,
       "type": "pr",
       "title": "",
-      "actionability": "needs-analysis",
+      "actionability": "done",
       "priorityScore": 0,
       "implementationScoreAuto": 0,
       "implementationScoreFinal": 20,
@@ -645,7 +645,7 @@
       "linkedIssues": [],
       "labels": [],
       "notePath": ".github/maintainer/notes/prs/000/PR-49.md",
-      "lastSeenAt": "2026-01-17T18:18:54.518Z"
+      "lastSeenAt": "2026-01-17T19:10:52.058Z"
     }
   ]
 }

.github/maintainer/notes/issues/000/ISSUE-13.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.

.github/maintainer/notes/issues/000/ISSUE-16.md

@@ -1,14 +1,14 @@
 ---
 id: 16
 type: issue
-status: open
-actionability: ready
+status: closed
+actionability: done
 priority_score: 7
 sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [bug]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:25:46Z
 ---
 ## Intent
 Prevent AGENTS usage text from triggering a `bash` call in Gemini CLI.
@@ -17,7 +17,10 @@ Prevent AGENTS usage text from triggering a `bash` call in Gemini CLI.
 The `Bash("...")` example is misinterpreted by Gemini CLI. Updated generated usage text to plain shell invocation.
 
 ## Proposed Action
-Respond noting the fix in v1.5.0; close after reporter confirmation.
+Respond noting the fix in v1.5.0; close as resolved.
 
 ## Draft Response (requires approval)
-- TODO: Draft the public response.
+Posted and closed after v1.5.0 release.
+
+## Resolution
+Closed as resolved in v1.5.0; usage text updated to plain shell invocation.

.github/maintainer/notes/issues/000/ISSUE-19.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.

.github/maintainer/notes/issues/000/ISSUE-24.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.

.github/maintainer/notes/issues/000/ISSUE-32.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.

.github/maintainer/notes/issues/000/ISSUE-35.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.

.github/maintainer/notes/issues/000/ISSUE-41.md

@@ -8,7 +8,7 @@ sentiment_score: 0
 needs_info_score: 0
 needs_info_signals: []
 labels: [enhancement]
-last_seen_at: 2026-01-17T19:10:52.058Z
+last_seen_at: 2026-01-17T19:26:09.772Z
 ---
 ## Intent
 - TODO: Summarize the reporter intent and underlying need.