@fro.bot/systematic 2.18.0 → 2.19.0

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   findCommandsInDir,
   findSkillsInDir,
   getConfigPaths
-} from "./index-ek6rskkw.js";
+} from "./index-6evyges6.js";
 
 // src/cli.ts
 import fs from "fs";

package/dist/{index-ek6rskkw.js → index-6evyges6.js}

@@ -500,6 +500,21 @@ function extractFrontmatter(filePath) {
         metadata = Object.fromEntries(entries);
       }
     }
+    const deprecatedRaw = data.deprecated;
+    let deprecated;
+    if (isRecord(deprecatedRaw)) {
+      const since = typeof deprecatedRaw.since === "string" && deprecatedRaw.since !== "" ? deprecatedRaw.since : undefined;
+      const removal = typeof deprecatedRaw.removal === "string" && deprecatedRaw.removal !== "" ? deprecatedRaw.removal : undefined;
+      if (since !== undefined && removal !== undefined) {
+        deprecated = { since, removal };
+        if (typeof deprecatedRaw.replacement === "string") {
+          deprecated.replacement = deprecatedRaw.replacement;
+        }
+        if (typeof deprecatedRaw.reason === "string") {
+          deprecated.reason = deprecatedRaw.reason;
+        }
+      }
+    }
     const argumentHintRaw = extractNonEmptyString(data, "argument-hint");
     const argumentHint = argumentHintRaw?.replace(/^["']|["']$/g, "") || undefined;
     return {
@@ -508,6 +523,7 @@ function extractFrontmatter(filePath) {
       license: extractNonEmptyString(data, "license"),
       compatibility: extractNonEmptyString(data, "compatibility"),
       metadata,
+      deprecated,
       disableModelInvocation: extractBoolean(data, "disable-model-invocation"),
       userInvocable: extractBoolean(data, "user-invocable"),
       subtask: data.context === "fork" ? true : extractBoolean(data, "subtask") ?? undefined,
@@ -538,6 +554,7 @@ function findSkillsInDir(dir, maxDepth = 3) {
         license: frontmatter.license,
         compatibility: frontmatter.compatibility,
         metadata: frontmatter.metadata,
+        deprecated: frontmatter.deprecated,
         disableModelInvocation: frontmatter.disableModelInvocation,
         userInvocable: frontmatter.userInvocable,
         subtask: frontmatter.subtask,

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   loadConfig,
   loadConfigWithSources,
   parseFrontmatter
-} from "./index-ek6rskkw.js";
+} from "./index-6evyges6.js";
 
 // src/index.ts
 import fs5 from "fs";
@@ -81,7 +81,8 @@ function loadSkill(skillInfo) {
       subtask: skillInfo.subtask,
       agent: skillInfo.agent,
       model: skillInfo.model,
-      argumentHint: skillInfo.argumentHint
+      argumentHint: skillInfo.argumentHint,
+      deprecated: skillInfo.deprecated
     };
   } catch {
     return null;
@@ -1186,8 +1187,25 @@ function discoverSkillFiles(dir, limit = 10) {
   return files.map((file) => `  <file>${file}</file>`).join(`
 `);
 }
+function formatDeprecationMessage(name, deprecated) {
+  let msg = `[systematic] skill "${name}" is deprecated since ${deprecated.since}; will be removed in ${deprecated.removal}.`;
+  if (deprecated.replacement) {
+    msg += ` Replacement: ${deprecated.replacement}`;
+    if (!deprecated.replacement.endsWith(".")) {
+      msg += ".";
+    }
+  }
+  if (deprecated.reason) {
+    msg += ` Reason: ${deprecated.reason}`;
+    if (!deprecated.reason.endsWith(".")) {
+      msg += ".";
+    }
+  }
+  return msg;
+}
 function createSkillTool(options) {
   const { bundledSkillsDir, disabledSkills } = options;
+  const warnedSkills = new Set;
   const getAllSkills = () => {
     return findSkillsInDir(bundledSkillsDir).filter((s) => !disabledSkills.includes(s.name)).map((skillInfo) => loadSkill(skillInfo)).filter((s) => s !== null).sort((a, b) => a.name.localeCompare(b.name));
   };
@@ -1238,6 +1256,10 @@ ${catalog}`;
         }).map((s) => s.prefixedName);
         throw new Error(`Skill "${requestedName}" not found. Available systematic skills: ${availableSystematic.join(", ")}`);
       }
+      if (matchedSkill.deprecated && !warnedSkills.has(matchedSkill.name)) {
+        console.warn(formatDeprecationMessage(matchedSkill.name, matchedSkill.deprecated));
+        warnedSkills.add(matchedSkill.name);
+      }
       const body = extractSkillBody(matchedSkill.wrappedTemplate);
       const dir = path6.dirname(matchedSkill.skillFile);
       const base = pathToFileURL2(dir).href;

package/dist/lib/skill-loader.d.ts

@@ -1,4 +1,4 @@
-import type { SkillInfo } from './skills.js';
+import type { SkillDeprecated, SkillInfo } from './skills.js';
 export interface LoadedSkill {
     name: string;
     prefixedName: string;
@@ -12,6 +12,7 @@ export interface LoadedSkill {
     agent?: string;
     model?: string;
     argumentHint?: string;
+    deprecated?: SkillDeprecated;
 }
 export declare function formatSkillCommandName(name: string): string;
 export declare function formatSkillDescription(description: string, fallbackName: string): string;

package/dist/lib/skills.d.ts

@@ -1,9 +1,16 @@
+export interface SkillDeprecated {
+    since: string;
+    removal: string;
+    replacement?: string;
+    reason?: string;
+}
 export interface SkillFrontmatter {
     name: string;
     description: string;
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
+    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -20,6 +27,7 @@ export interface SkillInfo {
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
+    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -28,6 +36,6 @@ export interface SkillInfo {
     argumentHint?: string;
     allowedTools?: string;
 }
-export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "user-invocable", "agent", "model", "context", "subtask"];
+export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "deprecated", "user-invocable", "agent", "model", "context", "subtask"];
 export declare function extractFrontmatter(filePath: string): SkillFrontmatter;
 export declare function findSkillsInDir(dir: string, maxDepth?: number): SkillInfo[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fro.bot/systematic",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "description": "Structured engineering workflows for OpenCode",
   "type": "module",
   "homepage": "https://fro.bot/systematic",
@@ -65,8 +65,8 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",
-    "@opencode-ai/plugin": "1.14.50",
-    "@opencode-ai/sdk": "1.14.50",
+    "@opencode-ai/plugin": "1.14.51",
+    "@opencode-ai/sdk": "1.14.51",
     "@types/bun": "latest",
     "@types/js-yaml": "4.0.9",
     "@types/node": "24.12.4",

package/skills/claude-permissions-optimizer/SKILL.md

@@ -3,6 +3,10 @@ name: claude-permissions-optimizer
 context: fork
 description: Optimize Claude Code permissions by finding safe Bash commands from session history and auto-applying them to settings.json. Can run from any coding agent but targets Claude Code specifically. Use when experiencing permission fatigue, too many permission prompts, wanting to optimize permissions, or needing to set up allowlists. Triggers on "optimize permissions", "reduce permission prompts", "allowlist commands", "too many permission prompts", "permission fatigue", "permission setup", or complaints about clicking approve too often.
 subtask: true
+deprecated:
+  since: v2.19.0
+  removal: v3.0.0
+  reason: "Targets Claude Code's ~/.claude/settings.json allowlist mechanism. OpenCode uses a SQLite-backed session-scoped permission model with built-in always-persistence via the always button. No prompt-fatigue analog exists in OpenCode; there is no equivalent allowlist to optimize."
 ---
 
 # Claude Permissions Optimizer

package/skills/orchestrating-swarms/SKILL.md

@@ -2,6 +2,11 @@
 name: orchestrating-swarms
 description: Use when orchestrating multi-agent swarms, coordinating parallel code reviews, creating pipeline workflows with dependencies, building self-organizing task queues, or any task benefiting from divide-and-conquer patterns.
 disable-model-invocation: true
+deprecated:
+  since: v2.19.0
+  removal: v3.0.0
+  replacement: orchestrating-subagents
+  reason: "Documents the CEP Teammate API (TeammateTool, spawnTeam, TaskCreate/TaskList/TaskGet, team_name parameter on task(), CC subagent_type names). These primitives do not exist in OpenCode. A replacement skill will cover OpenCode-native parallel task() orchestration."
 ---
 
 # Swarm Orchestration