@orderful/droid 0.11.1 → 0.13.0

package/dist/tools/droid/skills/droid/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: droid
+description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
+globs:
+  - "**/*"
+alwaysApply: false
+---
+
+# Droid
+
+Core meta-skill for droid update awareness.
+
+## Purpose
+
+Notify users about droid CLI updates from within Claude Code. Users who don't run `droid` often may miss updates - this skill proactively nudges them.
+
+## Update Checking
+
+### When to Check
+
+1. **Proactively** - Check for **droid CLI updates** once near the start of each session. This is specifically about the `@orderful/droid` npm package, not general software updates.
+2. **On request** - When user explicitly asks about droid updates ("any droid updates?", "is droid up to date?", "check droid version")
+
+### How to Check
+
+Run this command to get the latest published version:
+
+```bash
+npm view @orderful/droid version 2>/dev/null
+```
+
+Compare against the installed version. To find the installed version, check:
+
+```bash
+cat ~/.droid/config.yaml | grep -A1 "droid:" | grep "version:" | awk '{print $2}'
+```
+
+Or if droid skill isn't in config yet, check the npm global:
+
+```bash
+npm list -g @orderful/droid --depth=0 2>/dev/null | grep @orderful/droid | awk -F@ '{print $NF}'
+```
+
+### Update Notification Format
+
+When an update is available, output this notification:
+
+```
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v{latest} is available (you have v{current}).
+Run `droid` to update, then restart Claude Code.
+```
+
+Replace `{latest}` with the npm version and `{current}` with the installed version.
+
+### Session Tracking
+
+**Important:** Only show the update notification ONCE per session. After showing it:
+- Do not show it again in the same conversation
+- Do not repeat it even if user continues chatting
+
+If the user explicitly asks about updates again, you can confirm whether they're up to date.
+
+## Examples
+
+### Proactive Check (Session Start)
+
+User: "Help me refactor this function"
+
+*[Claude checks for droid updates as part of initial response]*
+
+```
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v0.12.0 is available (you have v0.11.0).
+Run `droid` to update, then restart Claude Code.
+
+---
+
+Now, let me help you refactor that function...
+```
+
+### User Request
+
+User: "Is droid up to date?"
+
+```
+Let me check...
+
+[● ●] "I suggest a new strategy: let the Wookiee update."
+
+Droid v0.12.0 is available (you have v0.11.0).
+Run `droid` to update, then restart Claude Code.
+```
+
+Or if already up to date:
+
+```
+[● ●] Droid is up to date (v0.12.0).
+```
+
+### Already Notified This Session
+
+User: "Any other updates?"
+
+```
+I already mentioned the droid update earlier. You're on v0.11.0, latest is v0.12.0.
+Run `droid` when you're ready to update.
+```
+
+## Behaviour Notes
+
+- Keep the check quick (timeout after 3 seconds)
+- If the npm check fails (network issues), silently skip - don't error
+- The droid eyes `[● ●]` and Star Wars quote are intentional branding - always include them
+- Be helpful but not annoying - one nudge per session is enough

package/dist/tools/droid/skills/droid/SKILL.yaml

@@ -0,0 +1,7 @@
+name: droid
+description: "Core droid meta-skill for update awareness. Checks for droid updates and notifies users from within Claude Code."
+version: 0.1.0
+status: beta
+dependencies: []
+provides_output: false
+config_schema: {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {