@orderful/droid 0.29.0 → 0.29.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "droid",
       "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
-      "version": "0.5.0",
+      "version": "0.5.1",
       "source": {
         "source": "github",
         "repo": "orderful/droid",

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @orderful/droid
 
+## 0.29.1
+
+### Patch Changes
+
+- [#173](https://github.com/Orderful/droid/pull/173) [`b999300`](https://github.com/Orderful/droid/commit/b999300f07c012a7bd6035013473cf514a000152) Thanks [@frytyler](https://github.com/frytyler)! - Fix system tool installation and clean up skill frontmatter:
+  - Fix `ensureSystemTools` to install ALL required skills (not just the first one), ensuring `droid-bootstrap` is auto-installed alongside `droid`
+  - Remove invalid `globs` and `alwaysApply` frontmatter fields from all skills (these are not official Claude Code fields)
+  - Restore `argument-hint` to all user-invocable skills for autocomplete support
+  - Improve droid skill description to trigger on more user phrasings
+
 ## 0.29.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -3131,11 +3131,13 @@ function useToolUpdates({ onUpdateComplete }) {
   const ensureSystemTools = useCallback(() => {
     const systemTools = tools.filter((t) => t.system === true);
     for (const systemTool of systemTools) {
-      const installed = isToolInstalled(systemTool.name);
+      const requiredSkills = systemTool.includes.skills.filter((s) => s.required);
       const updateStatus = getToolUpdateStatus(systemTool.name);
-      if (!installed || updateStatus.hasUpdate) {
-        const primarySkill = systemTool.includes.skills.find((s) => s.required)?.name || systemTool.name;
-        installSkill(primarySkill);
+      for (const skill of requiredSkills) {
+        const skillInstalled = isSkillInstalled(skill.name);
+        if (!skillInstalled || updateStatus.hasUpdate) {
+          installSkill(skill.name);
+        }
       }
     }
   }, [tools]);

package/dist/commands/tui/hooks/useToolUpdates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolUpdates.d.ts","sourceRoot":"","sources":["../../../../src/commands/tui/hooks/useToolUpdates.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1H;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChF,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,yBAAyB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,gBAAgB,EAAE,EAAE,qBAAqB,GAAG,oBAAoB,CAoFhG"}
+{"version":3,"file":"useToolUpdates.d.ts","sourceRoot":"","sources":["../../../../src/commands/tui/hooks/useToolUpdates.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1H;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChF,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,yBAAyB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,gBAAgB,EAAE,EAAE,qBAAqB,GAAG,oBAAoB,CAyFhG"}

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

@@ -1,9 +1,7 @@
 ---
 name: brain
 description: "Collaborative scratchpad for planning and research. Use when planning a feature, exploring a problem, or capturing thinking that should persist across sessions. User prompts like 'let's think through', 'open a scratchpad', 'plan this out', 'use our brain'."
-globs:
-  - "**/brain/**/*.md"
-alwaysApply: false
+argument-hint: "[{topic} | plan|research|review {topic} | idea|add {text} | check|done]"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
 ---
 

package/dist/tools/brain/skills/brain-obsidian/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: brain-obsidian
 description: "Obsidian extension for brain skill with YAML frontmatter, wikilinks, and PARA folder organization. Use when your brain docs live in an Obsidian vault."
-globs:
-  - "**/brain/**/*.md"
-alwaysApply: false
 allowed-tools: [Read, Write, Glob, Grep, Bash]
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 name: coach
 description: "Learning-mode AI assistance - scaffolds don't implement, questions don't fix. Use when learning a new codebase, wanting to understand deeply, or building skills to retain. User prompts like 'coach me on', 'help me think through', 'I want to learn how to', 'don't just give me the answer'."
-alwaysApply: false
+argument-hint: "[plan {task} | scaffold [{path}] | review [{path}] | check | challenge [{path}]]"
 allowed-tools: [Read, Grep, Glob]
 ---
 

package/dist/tools/code-review/skills/code-review/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: code-review
 description: "Comprehensive code review using specialized agents. Use when reviewing PRs, checking staged changes, or analysing code quality. User prompts like 'review this PR', 'check my changes', 'review before I commit'."
-globs:
-  - "**/*"
-alwaysApply: false
+argument-hint: "[#123 | staged | branch | path/to/file.ts]"
 allowed-tools: [Read, Grep, Glob, Bash, Task]
 ---
 

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

@@ -1,12 +1,7 @@
 ---
 name: codex
 description: "Shared organizational knowledge - PRDs, tech designs, patterns, and explored topics. Use when loading project context ('load transaction-templates'), searching codex ('search webhook'), capturing decisions ('codex decision'), or adding explored topics ('add topic'). User prompts like 'check the codex', 'what's in the codex about X', 'load the PRD for Y'."
-globs:
-  - "**/PRD.md"
-  - "**/TECH-DESIGN.md"
-  - "**/CONTEXT.md"
-  - "**/DECISIONS.md"
-alwaysApply: false
+argument-hint: "[projects | domains | proposals | patterns | topics | {name} | search {query} | new {type} {name} | decision {text}]"
 allowed-tools:
   [
     Read,

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

@@ -1,9 +1,7 @@
 ---
 name: comments
 description: "Inline conversations using @droid/@user markers in any file. Use when leaving async questions in code or having discussion that should stay near the code. User prompts like 'check for comments', 'address the @droid markers', 'clean up resolved comments'."
-globs:
-  - "**/*"
-alwaysApply: false
+argument-hint: "[check [{path}] | cleanup]"
 allowed-tools: [Read, Grep, Glob, Edit]
 ---
 

package/dist/tools/droid/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
   "author": {
     "name": "Orderful",

package/dist/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows."
-version: 0.5.0
+version: 0.5.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

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

@@ -1,9 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for updates, tool discovery, and usage help. Use when checking for droid updates, discovering available tools, or answering 'how do I...' questions about droid workflows. User prompts like 'any droid updates?', 'what tools do I have?', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?'."
-globs:
-  - "**/*"
-alwaysApply: false
+description: "Core droid meta-skill for updates, tool discovery, and usage help. Use when checking for droid updates, discovering available tools, or answering 'how do I...' questions about droid workflows. User prompts like 'any droid updates?', 'what tools do I have?', 'what tools do you have?', 'remind me what tools you have', 'hey droid what can you do', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?'."
 allowed-tools: [Bash]
 ---
 

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

@@ -1,8 +1,6 @@
 ---
 name: droid-bootstrap
 description: "Lightweight droid bootstrap for update awareness. Checks for droid updates once per session."
-globs: []
-alwaysApply: true
 allowed-tools: [Bash]
 ---
 

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

@@ -1,9 +1,7 @@
 ---
 name: project
 description: "Persistent project context for AI memory across sessions. Use when working on multi-session features, refactors, or any work that benefits from accumulated context. User prompts like 'load the project', 'update project context', 'what's the current project?'."
-globs:
-  - "**/PROJECT.md"
-alwaysApply: false
+argument-hint: "[{keywords} | update | create {name}]"
 allowed-tools: [Read, Write, Glob, Grep]
 ---
 

package/dist/tools/tech-design/skills/tech-design/SKILL.md

@@ -1,8 +1,7 @@
 ---
 name: tech-design
 description: "Technical design authoring with three-document approach - research doc (codebase discoveries), thought doc (design iteration), and roll-up (clean summary). Use when writing tech designs, drafting sections, exploring architectural ideas, or publishing to codex. User prompts like 'start tech design for X', 'draft the rollout section', 'let's think through the API design', 'publish this to codex'."
-globs: []
-alwaysApply: false
+argument-hint: "[start --from codex:{project} | draft [section] | think [topic] | gaps | publish]"
 allowed-tools:
   [Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*), Bash(mkdir:*), Task]
 ---

package/package.json

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

package/src/commands/tui/hooks/useToolUpdates.ts

@@ -1,12 +1,11 @@
 import { useState, useCallback } from 'react';
 import {
   getBundledTools,
-  isToolInstalled,
   getToolUpdateStatus,
   getToolsWithUpdates,
   type ToolUpdateInfo,
 } from '../../../lib/tools';
-import { installSkill, updateSkill } from '../../../lib/skills';
+import { installSkill, updateSkill, isSkillInstalled } from '../../../lib/skills';
 import { getAutoUpdateConfig, setAutoUpdateConfig } from '../../../lib/config';
 import type { ToolManifest } from '../../../lib/types';
 
@@ -35,12 +34,17 @@ export function useToolUpdates({ onUpdateComplete }: UseToolUpdatesOptions): Use
     const systemTools = tools.filter(t => (t as ToolManifest & { system?: boolean }).system === true);
 
     for (const systemTool of systemTools) {
-      const installed = isToolInstalled(systemTool.name);
+      // Install ALL required skills for system tools, not just the primary one
+      const requiredSkills = systemTool.includes.skills.filter(s => s.required);
       const updateStatus = getToolUpdateStatus(systemTool.name);
 
-      if (!installed || updateStatus.hasUpdate) {
-        const primarySkill = systemTool.includes.skills.find(s => s.required)?.name || systemTool.name;
-        installSkill(primarySkill);
+      for (const skill of requiredSkills) {
+        // Install if this specific skill is not installed, or if the tool has an update
+        const skillInstalled = isSkillInstalled(skill.name);
+
+        if (!skillInstalled || updateStatus.hasUpdate) {
+          installSkill(skill.name);
+        }
       }
     }
   }, [tools]);

package/src/tools/brain/skills/brain/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: brain
 description: "Collaborative scratchpad for planning and research. Use when planning a feature, exploring a problem, or capturing thinking that should persist across sessions. User prompts like 'let's think through', 'open a scratchpad', 'plan this out', 'use our brain'."
-globs:
-  - "**/brain/**/*.md"
-alwaysApply: false
+argument-hint: "[{topic} | plan|research|review {topic} | idea|add {text} | check|done]"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
 ---
 

package/src/tools/brain/skills/brain-obsidian/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: brain-obsidian
 description: "Obsidian extension for brain skill with YAML frontmatter, wikilinks, and PARA folder organization. Use when your brain docs live in an Obsidian vault."
-globs:
-  - "**/brain/**/*.md"
-alwaysApply: false
 allowed-tools: [Read, Write, Glob, Grep, Bash]
 ---
 

package/src/tools/coach/skills/coach/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: coach
 description: "Learning-mode AI assistance - scaffolds don't implement, questions don't fix. Use when learning a new codebase, wanting to understand deeply, or building skills to retain. User prompts like 'coach me on', 'help me think through', 'I want to learn how to', 'don't just give me the answer'."
-alwaysApply: false
+argument-hint: "[plan {task} | scaffold [{path}] | review [{path}] | check | challenge [{path}]]"
 allowed-tools: [Read, Grep, Glob]
 ---
 

package/src/tools/code-review/skills/code-review/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: code-review
 description: "Comprehensive code review using specialized agents. Use when reviewing PRs, checking staged changes, or analysing code quality. User prompts like 'review this PR', 'check my changes', 'review before I commit'."
-globs:
-  - "**/*"
-alwaysApply: false
+argument-hint: "[#123 | staged | branch | path/to/file.ts]"
 allowed-tools: [Read, Grep, Glob, Bash, Task]
 ---
 

package/src/tools/codex/skills/codex/SKILL.md

@@ -1,12 +1,7 @@
 ---
 name: codex
 description: "Shared organizational knowledge - PRDs, tech designs, patterns, and explored topics. Use when loading project context ('load transaction-templates'), searching codex ('search webhook'), capturing decisions ('codex decision'), or adding explored topics ('add topic'). User prompts like 'check the codex', 'what's in the codex about X', 'load the PRD for Y'."
-globs:
-  - "**/PRD.md"
-  - "**/TECH-DESIGN.md"
-  - "**/CONTEXT.md"
-  - "**/DECISIONS.md"
-alwaysApply: false
+argument-hint: "[projects | domains | proposals | patterns | topics | {name} | search {query} | new {type} {name} | decision {text}]"
 allowed-tools:
   [
     Read,

package/src/tools/comments/skills/comments/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: comments
 description: "Inline conversations using @droid/@user markers in any file. Use when leaving async questions in code or having discussion that should stay near the code. User prompts like 'check for comments', 'address the @droid markers', 'clean up resolved comments'."
-globs:
-  - "**/*"
-alwaysApply: false
+argument-hint: "[check [{path}] | cleanup]"
 allowed-tools: [Read, Grep, Glob, Edit]
 ---
 

package/src/tools/droid/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows.",
   "author": {
     "name": "Orderful",

package/src/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness, tool discovery, and usage help. Checks for updates, helps users find tools, and answers 'how do I...' questions about droid workflows."
-version: 0.5.0
+version: 0.5.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

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

@@ -1,9 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for updates, tool discovery, and usage help. Use when checking for droid updates, discovering available tools, or answering 'how do I...' questions about droid workflows. User prompts like 'any droid updates?', 'what tools do I have?', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?'."
-globs:
-  - "**/*"
-alwaysApply: false
+description: "Core droid meta-skill for updates, tool discovery, and usage help. Use when checking for droid updates, discovering available tools, or answering 'how do I...' questions about droid workflows. User prompts like 'any droid updates?', 'what tools do I have?', 'what tools do you have?', 'remind me what tools you have', 'hey droid what can you do', 'how do I add context?', 'remind me how to use codex', 'what's the best way to start a session?'."
 allowed-tools: [Bash]
 ---
 

package/src/tools/droid/skills/droid-bootstrap/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: droid-bootstrap
 description: "Lightweight droid bootstrap for update awareness. Checks for droid updates once per session."
-globs: []
-alwaysApply: true
 allowed-tools: [Bash]
 ---
 

package/src/tools/project/skills/project/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: project
 description: "Persistent project context for AI memory across sessions. Use when working on multi-session features, refactors, or any work that benefits from accumulated context. User prompts like 'load the project', 'update project context', 'what's the current project?'."
-globs:
-  - "**/PROJECT.md"
-alwaysApply: false
+argument-hint: "[{keywords} | update | create {name}]"
 allowed-tools: [Read, Write, Glob, Grep]
 ---
 

package/src/tools/tech-design/skills/tech-design/SKILL.md

@@ -1,8 +1,7 @@
 ---
 name: tech-design
 description: "Technical design authoring with three-document approach - research doc (codebase discoveries), thought doc (design iteration), and roll-up (clean summary). Use when writing tech designs, drafting sections, exploring architectural ideas, or publishing to codex. User prompts like 'start tech design for X', 'draft the rollout section', 'let's think through the API design', 'publish this to codex'."
-globs: []
-alwaysApply: false
+argument-hint: "[start --from codex:{project} | draft [section] | think [topic] | gaps | publish]"
 allowed-tools:
   [Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*), Bash(mkdir:*), Task]
 ---