claudekit-cli 4.0.0-dev.1 → 4.0.0-dev.2

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "4.0.0-dev.1",
-	"generatedAt": "2026-05-07T15:21:16.194Z",
+	"version": "4.0.0-dev.2",
+	"generatedAt": "2026-05-07T18:05:52.152Z",
 	"commands": {
 		"agents": {
 			"name": "agents",

package/dist/index.js

@@ -55509,6 +55509,11 @@ var init_skill_schema = __esm(() => {
         maxLength: 512,
         description: "Human-readable description of the skill and when to use it"
       },
+      when_to_use: {
+        type: "string",
+        maxLength: 1024,
+        description: "Additional invocation context appended to description in Claude Code skill listings"
+      },
       "user-invocable": {
         type: "boolean",
         description: "Whether the skill appears in the user slash-command menu. False keeps it available for agent invocation."
@@ -62354,7 +62359,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "4.0.0-dev.1",
+    version: "4.0.0-dev.2",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -84254,6 +84259,7 @@ async function scanSkills2(skillsDir2) {
       skills.push({
         id: normalizeSkillId(rawName, fallbackId),
         description: typeof data.description === "string" ? data.description : "",
+        whenToUse: typeof data.when_to_use === "string" ? data.when_to_use : "",
         file,
         userInvocable: typeof data["user-invocable"] === "boolean" ? data["user-invocable"] : undefined
       });
@@ -84315,9 +84321,17 @@ function estimateListingChars(skills, maxDescChars) {
   if (skills.length === 0)
     return 0;
   return skills.reduce((sum, skill) => {
-    return sum + skill.id.length + LISTING_OVERHEAD_PER_SKILL + Math.min(skill.description.length, maxDescChars);
+    return sum + skill.id.length + LISTING_OVERHEAD_PER_SKILL + Math.min(getListingText(skill).length, maxDescChars);
   }, skills.length - 1);
 }
+function getListingText(skill) {
+  if (!skill.whenToUse)
+    return skill.description;
+  if (!skill.description)
+    return skill.whenToUse;
+  return `${skill.description}
+${skill.whenToUse}`;
+}
 function requiredBudgetFraction(listingChars, contextTokens = CONTEXT_FLOOR_TOKENS) {
   if (listingChars <= 0)
     return DEFAULT_BUDGET_FRACTION;
@@ -84441,7 +84455,7 @@ function buildSkillOverridesCheck(settingsPath, read) {
   if (!read.settings || !Object.prototype.hasOwnProperty.call(read.settings, "skillOverrides")) {
     return pass("ck-skill-overrides-policy", "Skill Overrides Policy", "No skillOverrides configured");
   }
-  return warn("ck-skill-overrides-policy", "Skill Overrides Policy", "Project settings contain skillOverrides", [{ id: "skillOverrides", description: "", file: settingsPath }], "Remove skillOverrides and manage listing pressure with skillListingBudgetFraction, skillListingMaxDescChars, and inventory cleanup.");
+  return warn("ck-skill-overrides-policy", "Skill Overrides Policy", "Project settings contain skillOverrides", [{ id: "skillOverrides", description: "", whenToUse: "", file: settingsPath }], "Remove skillOverrides and manage listing pressure with skillListingBudgetFraction, skillListingMaxDescChars, and inventory cleanup.");
 }
 function buildUserInvocationCheck(activeSkills) {
   const disabled = activeSkills.filter((skill) => skill.userInvocable === false);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "4.0.0-dev.1",
+	"version": "4.0.0-dev.2",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {