@fro.bot/systematic 1.8.1 → 1.9.0

package/README.md

@@ -86,7 +86,7 @@ Skills are structured workflows that guide the AI through systematic engineering
 | `agent-browser` | Browser automation using Vercel's agent-browser CLI |
 | `agent-native-architecture` | Design systems where AI agents are first-class citizens |
 | `compound-docs` | Capture solved problems as categorized documentation |
-| `create-agent-skills` | Expert guidance for writing and refining skills |
+| `creating-agent-skills` | Expert guidance for writing and refining skills |
 | `file-todos` | File-based todo tracking with status and dependency management |
 | `git-worktree` | Manage git worktrees for isolated parallel development |
 

package/dist/index.js

@@ -11,7 +11,7 @@ import {
 } from "./index-yxbcy3s7.js";
 
 // src/index.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import path4 from "path";
 import { fileURLToPath } from "url";
 
@@ -276,7 +276,9 @@ function createConfigHandler(deps) {
 }
 
 // src/lib/skill-tool.ts
+import fs2 from "fs";
 import path3 from "path";
+import { pathToFileURL } from "url";
 import { tool } from "@opencode-ai/plugin/tool";
 function formatSkillsXml(skills) {
   if (skills.length === 0)
@@ -285,10 +287,44 @@ function formatSkillsXml(skills) {
     "  <skill>",
     `    <name>systematic:${skill.name}</name>`,
     `    <description>${skill.description}</description>`,
+    `    <location>${pathToFileURL(skill.path).href}</location>`,
     "  </skill>"
   ]);
   return ["<available_skills>", ...skillLines, "</available_skills>"].join(" ");
 }
+function discoverSkillFiles(dir, limit = 10) {
+  const files = [];
+  function shouldSkipDirectory(name) {
+    return name === ".git";
+  }
+  function shouldIncludeFile(name) {
+    return name !== "SKILL.md";
+  }
+  function handleEntry(entry, currentDir) {
+    if (entry.isDirectory()) {
+      if (!shouldSkipDirectory(entry.name)) {
+        recurse(path3.resolve(currentDir, entry.name));
+      }
+    } else if (shouldIncludeFile(entry.name)) {
+      files.push(path3.resolve(currentDir, entry.name));
+    }
+  }
+  function recurse(currentDir) {
+    if (files.length >= limit)
+      return;
+    try {
+      const entries = fs2.readdirSync(currentDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (files.length >= limit)
+          break;
+        handleEntry(entry, currentDir);
+      }
+    } catch {}
+  }
+  recurse(dir);
+  return files.map((file) => `  <file>${file}</file>`).join(`
+`);
+}
 function createSkillTool(options) {
   const { bundledSkillsDir, disabledSkills } = options;
   const getSystematicSkills = () => {
@@ -307,18 +343,26 @@ function createSkillTool(options) {
     }));
     const systematicXml = formatSkillsXml(skillInfos);
     return [
-      "Load a skill to get detailed instructions for a specific task.",
-      "Skills provide specialized knowledge and step-by-step guidance.",
-      "Use this when a task matches an available skill's description.",
-      "Only the skills listed here are available:",
+      "Load a specialized skill that provides domain-specific instructions and workflows.",
+      "",
+      "When you recognize that a task matches one of the available skills listed below, use this tool to load the full skill instructions.",
+      "",
+      "The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.",
+      "",
+      'Tool output includes a `<skill_content name="...">` block with the loaded content.',
+      "",
+      "The following skills provide specialized sets of instructions for particular tasks.",
+      "Invoke this tool to load a skill when a task matches one of the available skills listed below:",
+      "",
       systematicXml
-    ].join(" ");
+    ].join(`
+`);
   };
   const buildParameterHint = () => {
     const skills = getSystematicSkills();
     const examples = skills.slice(0, 3).map((s) => `'systematic:${s.name}'`).join(", ");
     const hint = examples.length > 0 ? ` (e.g., ${examples}, ...)` : "";
-    return `The skill identifier from available_skills${hint}`;
+    return `The name of the skill from available_skills${hint}`;
   };
   let cachedDescription = null;
   let cachedParameterHint = null;
@@ -348,6 +392,8 @@ function createSkillTool(options) {
       }
       const body = extractSkillBody(matchedSkill.wrappedTemplate);
       const dir = path3.dirname(matchedSkill.skillFile);
+      const base = pathToFileURL(dir).href;
+      const files = discoverSkillFiles(dir);
       await context.ask({
         permission: "skill",
         patterns: [matchedSkill.prefixedName],
@@ -361,13 +407,21 @@ function createSkillTool(options) {
           dir
         }
       });
-      return [
-        `## Skill: ${matchedSkill.prefixedName}`,
+      const output = [
+        `<skill_content name="${matchedSkill.prefixedName}">`,
+        `# Skill: ${matchedSkill.prefixedName}`,
         "",
-        `**Base directory**: ${dir}`,
+        body.trim(),
         "",
-        body.trim()
-      ].join(`
+        `Base directory for this skill: ${base}`,
+        "Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.",
+        "Note: file list is sampled."
+      ];
+      if (files) {
+        output.push("", "<skill_files>", files, "</skill_files>");
+      }
+      output.push("</skill_content>");
+      return output.join(`
 `);
     }
   });
@@ -383,9 +437,9 @@ var packageJsonPath = path4.join(packageRoot, "package.json");
 var hasLoggedInit = false;
 var getPackageVersion = () => {
   try {
-    if (!fs2.existsSync(packageJsonPath))
+    if (!fs3.existsSync(packageJsonPath))
       return "unknown";
-    const content = fs2.readFileSync(packageJsonPath, "utf8");
+    const content = fs3.readFileSync(packageJsonPath, "utf8");
     const parsed = JSON.parse(content);
     return parsed.version ?? "unknown";
   } catch {

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

@@ -9,4 +9,14 @@ export interface SkillToolOptions {
  * Uses indented format matching OpenCode's native skill tool.
  */
 export declare function formatSkillsXml(skills: SkillInfo[]): string;
+/**
+ * Discovers skill files in a directory and formats them as XML tags.
+ * Recursively searches subdirectories, includes hidden files, excludes .git and SKILL.md.
+ * Matches OpenCode v1.1.50 behavior exactly.
+ *
+ * @param dir - Directory path to search for skill files
+ * @param limit - Maximum number of files to return (default: 10)
+ * @returns String with absolute file paths formatted as XML tags, one per line
+ */
+export declare function discoverSkillFiles(dir: string, limit?: number): string;
 export declare function createSkillTool(options: SkillToolOptions): ToolDefinition;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fro.bot/systematic",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Structured engineering workflows for OpenCode",
   "type": "module",
   "main": "./dist/index.js",