@orderful/droid 0.17.0 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @orderful/droid
 
+## 0.17.2
+
+### Patch Changes
+
+- [#92](https://github.com/Orderful/droid/pull/92) [`865ab78`](https://github.com/Orderful/droid/commit/865ab7894c49e168ea677d9906486ac1de29fcee) Thanks [@frytyler](https://github.com/frytyler)! - Fix auto-update for app not triggering when enabled
+
+## 0.17.1
+
+### Patch Changes
+
+- [#90](https://github.com/Orderful/droid/pull/90) [`30abc1c`](https://github.com/Orderful/droid/commit/30abc1cd699a41ca7bbb699586b27246e99762e3) Thanks [@frytyler](https://github.com/frytyler)! - Improve /brain check to delegate to /comments check when available
+
+- [#89](https://github.com/Orderful/droid/pull/89) [`624518e`](https://github.com/Orderful/droid/commit/624518ec2ad0b9ac303ead7ae39684b8db73459e) Thanks [@frytyler](https://github.com/frytyler)! - Improve skill descriptions with "Use when" pattern for better Claude matching
+
+  Updated all skill frontmatter descriptions to follow the official Claude Code pattern:
+  `{What it does}. Use when {scenarios}. User prompts like {examples}.`
+
+  This helps Claude better recognise when to invoke skills based on user intent.
+
+  Bumps tool versions: brain 0.2.1, coach 0.1.1, code-review 0.1.1, comments 0.2.4, droid 0.2.1, project 0.1.3
+
 ## 0.17.0
 
 ### Minor Changes

package/dist/bin/droid.js

@@ -1407,7 +1407,7 @@ async function updateCommand(tool, options) {
 
 // src/commands/tui.tsx
 import { render, Box as Box12, Text as Text13, useInput as useInput7, useApp as useApp2 } from "ink";
-import { useState as useState9 } from "react";
+import { useState as useState9, useEffect } from "react";
 
 // src/commands/tui/constants.ts
 var colors = {
@@ -2709,6 +2709,12 @@ function App() {
       }
     }
   });
+  useEffect(() => {
+    const autoUpdateConfig = getAutoUpdateConfig();
+    if (autoUpdateConfig.app && updateInfo.hasUpdate && view === "welcome" && !isUpdating) {
+      handleUpdate();
+    }
+  }, [updateInfo.hasUpdate, view, isUpdating, handleUpdate]);
   const proceedToNextView = () => {
     if (!configExists()) {
       setView("setup");

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

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AA2cA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBhD"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/commands/tui.tsx"],"names":[],"mappings":"AAmdA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBhD"}

package/dist/tools/brain/TOOL.yaml

@@ -1,6 +1,6 @@
 name: brain
 description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: brain
-description: "Your scratchpad (or brain) - a collaborative space for planning and research. Triggers on phrases like 'let's use our brain', 'open a scratchpad', or 'plan this out' to capture AI output into a persistent doc. Create docs with /brain plan (or /scratchpad plan), /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
+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
@@ -148,7 +148,7 @@ Full procedure: `references/workflows.md` § Adding
 
 **Trigger:** `/brain check`
 
-**TLDR:** Find `> @droid` comments in active doc, address each one with `> @{user_mention}` response (always use blockquote `>`).
+**TLDR:** Invoke `/comments check {active_doc_path}`. If unavailable, find `> @droid` comments and address each (preserve original, add response below).
 
 Full procedure: `references/workflows.md` § Checking
 

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

@@ -1,6 +1,6 @@
 ---
 name: brain-obsidian
-description: "Obsidian extension for brain skill. Adds YAML frontmatter, wikilinks, and folder organization. Requires brain skill. Install this to use brain docs with your Obsidian vault."
+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

package/dist/tools/coach/TOOL.yaml

@@ -1,6 +1,6 @@
 name: coach
 description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
-version: 0.1.0
+version: 0.1.1
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: coach
-description: "Learning-mode AI assistance - AI as coach, not crutch. Triggers on phrases like 'help me think through', 'coach me on', 'I want to learn how to', or 'don't just give me the answer'. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions on your code."
+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
 allowed-tools: Read, Grep, Glob
 ---

package/dist/tools/code-review/TOOL.yaml

@@ -1,6 +1,6 @@
 name: code-review
 description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring."
-version: 0.1.0
+version: 0.1.1
 status: alpha
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: code-review
-description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files. Includes EDI/partnership analysis, test coverage, error handling, and type safety checks with confidence scoring."
+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

package/dist/tools/comments/TOOL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
-version: 0.2.3
+version: 0.2.4
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: comments
-description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
+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

package/dist/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

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

@@ -1,6 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+description: "Core droid meta-skill for updates and tool discovery. Use when checking for droid updates or discovering available tools. User prompts like 'any droid updates?', 'what tools do I have?', 'is droid up to date?'."
 globs:
   - "**/*"
 alwaysApply: false

package/dist/tools/project/TOOL.yaml

@@ -1,6 +1,6 @@
 name: project
 description: "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features."
-version: 0.1.2
+version: 0.1.3
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: project
-description: "Manage project context files for persistent AI memory across sessions. Load project context before working (/project {name}), update with new learnings (/project update), or create new projects (/project create). Use when working on multi-session features, refactors, or any work that benefits from accumulated context."
+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

package/package.json

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

package/src/commands/tui.tsx

@@ -1,5 +1,5 @@
 import { render, Box, Text, useInput, useApp } from 'ink';
-import { useState } from 'react';
+import { useState, useEffect } from 'react';
 import {
   getBundledSkills,
   installSkill,
@@ -7,7 +7,7 @@ import {
   updateSkill,
 } from '../lib/skills';
 import { getBundledTools, isToolInstalled, getToolUpdateStatus } from '../lib/tools';
-import { configExists, loadConfig } from '../lib/config';
+import { configExists, loadConfig, getAutoUpdateConfig } from '../lib/config';
 import { Platform, type ConfigOption, type ToolManifest } from '../lib/types';
 import { getVersion } from '../lib/version';
 import { type Tab, type View } from './tui/types';
@@ -60,6 +60,14 @@ function App() {
     },
   });
 
+  // Auto-update app if enabled and update available
+  useEffect(() => {
+    const autoUpdateConfig = getAutoUpdateConfig();
+    if (autoUpdateConfig.app && updateInfo.hasUpdate && view === 'welcome' && !isUpdating) {
+      handleUpdate();
+    }
+  }, [updateInfo.hasUpdate, view, isUpdating, handleUpdate]);
+
   const proceedToNextView = () => {
     if (!configExists()) {
       setView('setup');

package/src/tools/brain/TOOL.yaml

@@ -1,6 +1,6 @@
 name: brain
 description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: brain
-description: "Your scratchpad (or brain) - a collaborative space for planning and research. Triggers on phrases like 'let's use our brain', 'open a scratchpad', or 'plan this out' to capture AI output into a persistent doc. Create docs with /brain plan (or /scratchpad plan), /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
+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
@@ -148,7 +148,7 @@ Full procedure: `references/workflows.md` § Adding
 
 **Trigger:** `/brain check`
 
-**TLDR:** Find `> @droid` comments in active doc, address each one with `> @{user_mention}` response (always use blockquote `>`).
+**TLDR:** Invoke `/comments check {active_doc_path}`. If unavailable, find `> @droid` comments and address each (preserve original, add response below).
 
 Full procedure: `references/workflows.md` § Checking
 

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

@@ -1,6 +1,6 @@
 ---
 name: brain-obsidian
-description: "Obsidian extension for brain skill. Adds YAML frontmatter, wikilinks, and folder organization. Requires brain skill. Install this to use brain docs with your Obsidian vault."
+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

package/src/tools/coach/TOOL.yaml

@@ -1,6 +1,6 @@
 name: coach
 description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
-version: 0.1.0
+version: 0.1.1
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: coach
-description: "Learning-mode AI assistance - AI as coach, not crutch. Triggers on phrases like 'help me think through', 'coach me on', 'I want to learn how to', or 'don't just give me the answer'. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions on your code."
+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
 allowed-tools: Read, Grep, Glob
 ---

package/src/tools/code-review/TOOL.yaml

@@ -1,6 +1,6 @@
 name: code-review
 description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring."
-version: 0.1.0
+version: 0.1.1
 status: alpha
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: code-review
-description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files. Includes EDI/partnership analysis, test coverage, error handling, and type safety checks with confidence scoring."
+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

package/src/tools/comments/TOOL.yaml

@@ -1,6 +1,6 @@
 name: comments
 description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
-version: 0.2.3
+version: 0.2.4
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: comments
-description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
+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

package/src/tools/droid/TOOL.yaml

@@ -1,6 +1,6 @@
 name: droid
 description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
-version: 0.2.0
+version: 0.2.1
 status: beta
 
 # System tool - always stays current regardless of auto-update settings

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

@@ -1,6 +1,6 @@
 ---
 name: droid
-description: "Core droid meta-skill for update awareness and tool discovery. Checks for updates and helps users find the right tools."
+description: "Core droid meta-skill for updates and tool discovery. Use when checking for droid updates or discovering available tools. User prompts like 'any droid updates?', 'what tools do I have?', 'is droid up to date?'."
 globs:
   - "**/*"
 alwaysApply: false

package/src/tools/project/TOOL.yaml

@@ -1,6 +1,6 @@
 name: project
 description: "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features."
-version: 0.1.2
+version: 0.1.3
 status: beta
 
 includes:

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

@@ -1,6 +1,6 @@
 ---
 name: project
-description: "Manage project context files for persistent AI memory across sessions. Load project context before working (/project {name}), update with new learnings (/project update), or create new projects (/project create). Use when working on multi-session features, refactors, or any work that benefits from accumulated context."
+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