@vibe-agent-toolkit/cli 0.1.32-rc.3 → 0.1.32-rc.5

package/dist/utils/skill-quality-footer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Skill-quality checklist footer
+ *
+ * Shared footer rendered by `vat audit` and `vat skills validate` when at
+ * least one skill-level finding is present (warnings or errors against
+ * SKILL.md files, or any of the newer quality codes). Suppressed on clean
+ * runs so footers don't become ambient advertising.
+ */
+import type { createLogger } from './logger.js';
+/**
+ * Validation codes that always justify showing the footer when they appear,
+ * even if no other skill-level issues fire (they are the quality-checklist
+ * items most likely to benefit from the rubric's rationale).
+ */
+export declare const SKILL_QUALITY_FOOTER_CODES: ReadonlySet<string>;
+/**
+ * Render the footer to stderr when conditions are met.
+ *
+ * Shown when:
+ *  - any issue with one of SKILL_QUALITY_FOOTER_CODES fired, OR
+ *  - `hasSkillFindings` is true (at least one warning or error on a SKILL.md).
+ *
+ * Idempotent-safe: the caller decides once whether to call this.
+ */
+export declare function renderSkillQualityFooter(logger: ReturnType<typeof createLogger>, hasSkillFindings: boolean, emittedCodes: Iterable<string>): void;
+//# sourceMappingURL=skill-quality-footer.d.ts.map

package/dist/utils/skill-quality-footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-quality-footer.d.ts","sourceRoot":"","sources":["../../src/utils/skill-quality-footer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAMzD,CAAC;AAIH;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACvC,gBAAgB,EAAE,OAAO,EACzB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC7B,IAAI,CAeN"}

package/dist/utils/skill-quality-footer.js

@@ -0,0 +1,45 @@
+/**
+ * Skill-quality checklist footer
+ *
+ * Shared footer rendered by `vat audit` and `vat skills validate` when at
+ * least one skill-level finding is present (warnings or errors against
+ * SKILL.md files, or any of the newer quality codes). Suppressed on clean
+ * runs so footers don't become ambient advertising.
+ */
+/**
+ * Validation codes that always justify showing the footer when they appear,
+ * even if no other skill-level issues fire (they are the quality-checklist
+ * items most likely to benefit from the rubric's rationale).
+ */
+export const SKILL_QUALITY_FOOTER_CODES = new Set([
+    'SKILL_DESCRIPTION_OVER_CLAUDE_CODE_LIMIT',
+    'SKILL_DESCRIPTION_FILLER_OPENER',
+    'SKILL_DESCRIPTION_WRONG_PERSON',
+    'SKILL_NAME_MISMATCHES_DIR',
+    'SKILL_TIME_SENSITIVE_CONTENT',
+]);
+const FOOTER_LINE = `ℹ For the full pre-publication rubric and rationale on each finding, load the 'vat-skill-review' skill (from the vibe-agent-toolkit plugin) or see https://github.com/jdutton/vibe-agent-toolkit/blob/main/packages/vat-development-agents/resources/skills/vat-skill-review.md`;
+/**
+ * Render the footer to stderr when conditions are met.
+ *
+ * Shown when:
+ *  - any issue with one of SKILL_QUALITY_FOOTER_CODES fired, OR
+ *  - `hasSkillFindings` is true (at least one warning or error on a SKILL.md).
+ *
+ * Idempotent-safe: the caller decides once whether to call this.
+ */
+export function renderSkillQualityFooter(logger, hasSkillFindings, emittedCodes) {
+    const hasNewCode = (() => {
+        for (const code of emittedCodes) {
+            if (SKILL_QUALITY_FOOTER_CODES.has(code)) {
+                return true;
+            }
+        }
+        return false;
+    })();
+    if (!hasSkillFindings && !hasNewCode) {
+        return;
+    }
+    logger.info(`\n${FOOTER_LINE}`);
+}
+//# sourceMappingURL=skill-quality-footer.js.map

package/dist/utils/skill-quality-footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-quality-footer.js","sourceRoot":"","sources":["../../src/utils/skill-quality-footer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC;IACrE,0CAA0C;IAC1C,iCAAiC;IACjC,gCAAgC;IAChC,2BAA2B;IAC3B,8BAA8B;CAC/B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,iRAAiR,CAAC;AAEtS;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAuC,EACvC,gBAAyB,EACzB,YAA8B;IAE9B,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE;QACvB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC,gBAAgB,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/docs/audit.md

@@ -276,7 +276,7 @@ Warnings indicate potential issues but don't prevent usage:
 | `SKILL_MISSING_DESCRIPTION` | error | `description` field missing from frontmatter | Add `description` field |
 | `SKILL_NAME_INVALID` | error | Name contains invalid characters | Use only letters, numbers, hyphens, underscores |
 | `SKILL_DESCRIPTION_TOO_LONG` | error | Description exceeds 500 characters | Shorten description |
-| `SKILL_NAME_RESERVED_WORD` | error | Name is a reserved word | Choose a different name |
+| `RESERVED_WORD_IN_NAME` | warning | Name contains `anthropic` or `claude`; Claude Code rejects non-certified skills using these words | Rename the skill to avoid these words |
 | `SKILL_NAME_XML_TAGS` | error | Name contains XML-like tags | Remove XML tags from name |
 | `SKILL_DESCRIPTION_XML_TAGS` | error | Description contains XML-like tags | Remove XML tags from description |
 | `SKILL_DESCRIPTION_EMPTY` | error | Description is empty or whitespace | Provide meaningful description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/cli",
-  "version": "0.1.32-rc.3",
+  "version": "0.1.32-rc.5",
   "description": "Command-line interface for vibe-agent-toolkit",
   "type": "module",
   "bin": {
@@ -41,16 +41,16 @@
   "//dependencies-note": "DO NOT add example agent packages or adopter packages here. Adopter packages (like vat-development-agents) depend on the CLI binary at build time — declaring them as deps creates a circular build dependency. They are built in a second turbo pass via package#task overrides in turbo.json.",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@vibe-agent-toolkit/agent-config": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/agent-schema": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/agent-skills": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/claude-marketplace": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/discovery": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/gateway-mcp": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/rag": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/rag-lancedb": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/resources": "0.1.32-rc.3",
-    "@vibe-agent-toolkit/utils": "0.1.32-rc.3",
+    "@vibe-agent-toolkit/agent-config": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/agent-schema": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/agent-skills": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/claude-marketplace": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/discovery": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/gateway-mcp": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/rag": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/rag-lancedb": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/resources": "0.1.32-rc.5",
+    "@vibe-agent-toolkit/utils": "0.1.32-rc.5",
     "adm-zip": "^0.5.16",
     "commander": "^12.1.0",
     "js-yaml": "^4.1.0",