@callmeradical/augy 0.3.0 → 0.5.0

package/dist/author-G46NJ3OW.js

@@ -0,0 +1,109 @@
+import {
+  AGENTS,
+  agentSkillPath,
+  detectInstalledAgents
+} from "./chunk-V5GA2ZHU.js";
+import {
+  createSkillRecord,
+  getSkill,
+  readRegistry,
+  upsertSkill,
+  writeRegistry
+} from "./chunk-JM4VVAHN.js";
+
+// src/commands/author.ts
+import { intro, outro, multiselect, isCancel } from "@clack/prompts";
+import chalk from "chalk";
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { spawn } from "child_process";
+function skillTemplate(name) {
+  return `# Skill: ${name}
+
+## Overview
+
+<!-- Describe what this skill does and when to use it. -->
+
+## Workflow
+
+<!-- Step-by-step instructions for the agent. -->
+
+1. 
+
+## Notes
+
+<!-- Tips, caveats, or references. -->
+`;
+}
+async function authorNewCommand(name, opts = {}) {
+  intro(chalk.bold("augy") + chalk.dim(` \u2014 author new ${name}`));
+  const registry = await readRegistry();
+  if (getSkill(registry, name)) {
+    throw new Error(`Skill "${name}" already exists in the registry. Use \`augy author edit ${name}\` to open it.`);
+  }
+  const available = detectInstalledAgents();
+  if (!available.length) {
+    throw new Error("No agents detected. Install an agent first.");
+  }
+  const selected = available.length === 1 ? [available[0].id] : await multiselect({
+    message: "Install for which agents?",
+    options: available.map((a) => ({ value: a.id, label: a.name })),
+    initialValues: available.map((a) => a.id)
+  });
+  if (isCancel(selected)) {
+    console.log(chalk.dim("Cancelled."));
+    process.exit(0);
+  }
+  const targetAgents = AGENTS.filter((a) => selected.includes(a.id));
+  const agentPaths = {};
+  for (const agent of targetAgents) {
+    const dest = agentSkillPath(agent, name);
+    agentPaths[agent.id] = dest;
+    await mkdir(dest, { recursive: true });
+    await writeFile(join(dest, "SKILL.md"), skillTemplate(name), "utf8");
+  }
+  const record = createSkillRecord({
+    name,
+    source: "",
+    gigetSource: "",
+    sha: "unversioned",
+    agentIds: targetAgents.map((a) => a.id),
+    agentPaths
+  });
+  upsertSkill(registry, record);
+  await writeRegistry(registry);
+  const firstPath = agentPaths[targetAgents[0].id];
+  outro(
+    `${chalk.green("\u2713")} ${chalk.cyan(name)} created
+` + chalk.dim(`  ${firstPath}
+`) + chalk.dim("  Run `augy home push` when ready to back it up.")
+  );
+  if (!opts.noEdit) {
+    openInEditor(firstPath);
+  }
+}
+async function authorEditCommand(name) {
+  const registry = await readRegistry();
+  const skill = getSkill(registry, name);
+  if (!skill) {
+    throw new Error(`Skill "${name}" not found in registry. Run \`augy list\` to see installed skills.`);
+  }
+  const agentPath = Object.values(skill.agents).find((a) => a.active)?.path;
+  if (!agentPath) {
+    throw new Error(`No active agent path found for "${name}".`);
+  }
+  console.log(chalk.dim(`Opening ${agentPath}\u2026`));
+  openInEditor(agentPath);
+}
+function openInEditor(path) {
+  const editor = process.env["EDITOR"] ?? process.env["VISUAL"] ?? "vi";
+  const child = spawn(editor, [path], {
+    stdio: "inherit",
+    detached: true
+  });
+  child.unref();
+}
+export {
+  authorEditCommand,
+  authorNewCommand
+};

package/dist/{chunk-RBF4Q6N4.js → chunk-A3USXURD.js}

@@ -416,6 +416,7 @@ async function filterableMultiselect(opts) {
   const allOptions = opts.options.map((o) => ({ value: o.value, label: o.label, hint: o.hint }));
   const initialValues = opts.options.filter((o) => o.selected).map((o) => o.value);
   let filterText = "";
+  let filterMode = false;
   let matchCount = allOptions.length;
   const pageSize = opts.pageSize ?? Math.min(14, process2.stdout.rows - 6);
   const prompt = new wD({
@@ -438,11 +439,11 @@ ${headerPrefix}  ${opts.message}` + chalk.dim(`  (${allOptions.length} total)
 ${chalk.gray(S_BAR)}
 `;
       }
-      const cursor = filterText.length > 0 ? chalk.inverse(" ") : chalk.inverse(chalk.hidden("_"));
       const noMatch = matchCount === 0 && filterText.length > 0;
       const matchLabel = noMatch ? chalk.red("no matches") : filterText ? chalk.dim(`${matchCount} matched`) : chalk.dim(`${allOptions.length} skills`);
-      const hint = chalk.dim("space select \xB7 a all \xB7 enter confirm");
-      const filterLine = `${chalk.cyan(S_BAR)}  ` + chalk.dim("/ ") + (filterText ? chalk.white(filterText) : chalk.dim("type to filter")) + cursor + `  ${matchLabel}  ${hint}`;
+      const hint = filterMode ? chalk.dim("esc to clear \xB7 enter confirm") : chalk.dim("/ filter \xB7 a all \xB7 space select \xB7 enter confirm");
+      const filterDisplay = filterMode ? chalk.white(filterText) + chalk.inverse(" ") : filterText ? chalk.dim("/ ") + chalk.white(filterText) + chalk.dim(" (/ to edit)") : chalk.dim("/ to filter");
+      const filterLine = `${filterMode ? chalk.cyan(S_BAR) : chalk.gray(S_BAR)}  ` + filterDisplay + `  ${matchLabel}  ${hint}`;
       const visibleOptions = paginate(
         this.options,
         this.cursor,
@@ -471,19 +472,47 @@ ${chalk.cyan(S_BAR_END)}
     }
   });
   prompt.on("key", (key) => {
-    if (key === "\b" || key === "\x7F" || key === "backspace") {
-      filterText = filterText.slice(0, -1);
-    } else if (key && key.length === 1 && key.charCodeAt(0) >= 32) {
-      if (key === " ") return;
-      filterText += key;
-    } else {
+    const p = prompt;
+    if (filterMode) {
+      if (key === "\x1B") {
+        filterMode = false;
+        filterText = "";
+      } else if (key === "\b" || key === "\x7F" || key === "backspace") {
+        if (filterText.length > 0) {
+          filterText = filterText.slice(0, -1);
+        } else {
+          filterMode = false;
+        }
+      } else if (key === "/") {
+        filterMode = false;
+        return;
+      } else if (key && key.length === 1 && key.charCodeAt(0) >= 32 && key !== " ") {
+        filterText += key;
+      } else {
+        return;
+      }
+      const filtered = filterText ? allOptions.filter((o) => o.label.toLowerCase().includes(filterText.toLowerCase())) : allOptions;
+      matchCount = filtered.length;
+      p.options = filtered;
+      if (p.cursor >= filtered.length) p.cursor = Math.max(0, filtered.length - 1);
+      return;
+    }
+    if (key === "/") {
+      filterMode = true;
       return;
     }
-    const filtered = filterText ? allOptions.filter((o) => o.label.toLowerCase().includes(filterText.toLowerCase())) : allOptions;
-    matchCount = filtered.length;
-    prompt.options = filtered;
-    if (prompt.cursor >= filtered.length) {
-      prompt.cursor = Math.max(0, filtered.length - 1);
+    if (key === "a") {
+      const visibleValues = p.options.map((o) => o.value);
+      const currentSelected = Array.isArray(p.value) ? p.value : [];
+      const allVisible = visibleValues.every((v2) => currentSelected.includes(v2));
+      if (allVisible) {
+        p.value = currentSelected.filter((v2) => !visibleValues.includes(v2));
+      } else {
+        const union = [...currentSelected];
+        for (const v2 of visibleValues) if (!union.includes(v2)) union.push(v2);
+        p.value = union;
+      }
+      return;
     }
   });
   const result = await prompt.prompt();

package/dist/index.js

@@ -10,7 +10,7 @@ var pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8")
 var program = new Command();
 program.name("augy").description("Homebrew for AI agent skills \u2014 install, version, update, rollback").version(pkg.version);
 program.command("install [url]").description("Install skills from a GitHub URL or owner/repo[/path]").option("-a, --agent <agents...>", "Target agent(s): opencode, claude, codex").action(async (url, opts) => {
-  const { installCommand } = await import("./install-7ZWHGCFN.js");
+  const { installCommand } = await import("./install-27YDQ46H.js");
   await installCommand(url, opts ?? {});
 });
 program.command("update [skill]").description("Check for upstream changes and upgrade installed skills").action(async (skill) => {
@@ -36,7 +36,7 @@ program.command("sync [path]").description("Install/update skills from an augy.j
   await syncCommand(path, opts ?? {});
 });
 program.command("scan").description("Find skills installed outside augy and optionally import them into the registry").action(async () => {
-  const { scanCommand } = await import("./scan-CC4IYZ35.js");
+  const { scanCommand } = await import("./scan-6HFU774V.js");
   await scanCommand();
 });
 program.command("info <skill>").description("Show full metadata, version history, and description for an installed skill").action(async (skill) => {
@@ -78,6 +78,15 @@ program.command("pin <skill>").description("Pin a skill so it is skipped during
 program.command("unpin <skill>").description("Allow a pinned skill to receive updates again").action(async (skill) => {
   await setPinned(skill, false);
 });
+var author = program.command("author").description("Create and edit self-authored skills");
+author.command("new <name>").description("Scaffold a new skill and open it in $EDITOR").option("--no-edit", "Skip opening the editor after creating").action(async (name, opts) => {
+  const { authorNewCommand } = await import("./author-G46NJ3OW.js");
+  await authorNewCommand(name, { noEdit: !opts.edit });
+});
+author.command("edit <name>").description("Open an existing skill in $EDITOR").action(async (name) => {
+  const { authorEditCommand } = await import("./author-G46NJ3OW.js");
+  await authorEditCommand(name);
+});
 var home = program.command("home").description("Manage a personal GitHub repo for backing up your skills manifest");
 home.command("set <repo>").description("Set the home repo  e.g. augy home set alice/my-skills").option("--path <file>", "Manifest path within the repo (default: augy.json)").option("--skills-path <dir>", "Dir for authored skills in the repo (default: skills)").action(async (repo, opts) => {
   const { homeSetCommand } = await import("./home-TWK3PMCL.js");
@@ -96,7 +105,7 @@ home.command("show").description("Show the current home repo configuration").act
   await homeShowCommand();
 });
 program.action(async () => {
-  const { installCommand } = await import("./install-7ZWHGCFN.js");
+  const { installCommand } = await import("./install-27YDQ46H.js");
   await installCommand();
 });
 program.parse();

package/dist/{install-7ZWHGCFN.js → install-27YDQ46H.js}

@@ -1,6 +1,6 @@
 import {
   filterableMultiselect
-} from "./chunk-RBF4Q6N4.js";
+} from "./chunk-A3USXURD.js";
 import {
   resolveSkillFromTaps
 } from "./chunk-HZSFPII7.js";

package/dist/{scan-CC4IYZ35.js → scan-6HFU774V.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-KCQY4IDO.js";
 import {
   filterableMultiselect
-} from "./chunk-RBF4Q6N4.js";
+} from "./chunk-A3USXURD.js";
 import {
   resolveSkillFromTaps
 } from "./chunk-HZSFPII7.js";
@@ -52,6 +52,7 @@ async function scanCommand() {
       untracked.push({ name, agents });
     }
   }
+  const additionalInstalls = findAdditionalAgentInstalls(onDisk, registry);
   const tracked = listSkills(registry);
   if (!untracked.length) {
     outro(chalk.green("All installed skills are already tracked by augy."));
@@ -224,6 +225,36 @@ async function scanCommand() {
   outro(
     importedCount > 0 ? chalk.green(`${importedCount} skill(s) imported into augy`) : chalk.dim("No skills imported.")
   );
+  if (additionalInstalls.length) {
+    console.log(
+      `
+  ${chalk.bold("Additional installs found")}` + chalk.dim(` (${additionalInstalls.length} skill(s) installed in new agent(s))`) + "\n"
+    );
+    for (const { skillName, newAgents } of additionalInstalls) {
+      console.log(`  ${chalk.cyan.bold(skillName)}`);
+      for (const { agent, path } of newAgents) {
+        console.log(`    ${chalk.bold(agent.name.padEnd(10))}  ${chalk.dim(tildefy(path))}`);
+      }
+    }
+    console.log();
+    const doRegister = await confirm({
+      message: "Register these additional agent paths in the registry?"
+    });
+    if (!isCancel(doRegister) && doRegister) {
+      let registered = 0;
+      for (const { skillName, newAgents } of additionalInstalls) {
+        const skill = getSkill(registry, skillName);
+        for (const { agent, path } of newAgents) {
+          skill.agents[agent.id] = { path, active: true };
+          registered++;
+        }
+        registry.skills[skillName] = skill;
+        await writeRegistry(registry);
+      }
+      console.log(chalk.green(`
+  \u2713 Registered ${registered} additional path(s)`));
+    }
+  }
 }
 function printDetected(sk) {
   const p = sk.provenance;
@@ -309,6 +340,18 @@ async function readSkillDescription(skillPath) {
   }
   return void 0;
 }
+function findAdditionalAgentInstalls(onDisk, registry) {
+  const result = [];
+  for (const [name, agents] of onDisk) {
+    const tracked = getSkill(registry, name);
+    if (!tracked) continue;
+    const newAgents = agents.filter((a) => !tracked.agents[a.agent.id]);
+    if (newAgents.length) {
+      result.push({ skillName: name, newAgents });
+    }
+  }
+  return result;
+}
 function tildefy(p) {
   const home = homedir();
   return p.startsWith(home) ? "~" + p.slice(home.length) : p;
@@ -324,5 +367,6 @@ async function tryResolveTapSource(registry, name) {
   }
 }
 export {
+  findAdditionalAgentInstalls,
   scanCommand
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callmeradical/augy",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Homebrew for AI agent skills — install, version, update, rollback",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,7 @@
   ],
   "files": [
     "dist/**/*",
+    "skills/**/*",
     "README.md",
     "LICENSE"
   ],

package/skills/author/SKILL.md

@@ -0,0 +1,81 @@
+# Skill: author
+
+A meta-skill for authoring new augy skills. Use this when the user wants
+to create a new skill for their AI agents.
+
+## What is an augy skill?
+
+A skill is a directory containing a `SKILL.md` file. That file is loaded
+by an AI agent as context — giving it specialised knowledge, workflows,
+or tool integrations for a specific task.
+
+Skills are installed per-agent:
+```
+~/.opencode/skills/<name>/SKILL.md
+~/.claude/skills/<name>/SKILL.md
+~/.codex/skills/<name>/SKILL.md
+```
+
+## Workflow
+
+### 1. Scaffold the skill
+
+```sh
+augy author new <name>
+```
+
+This creates the skill directory for your installed agents, registers it
+in the augy registry, and opens it in `$EDITOR`.
+
+### 2. Write the SKILL.md
+
+A good SKILL.md has:
+
+- **One-line description** — what this skill does and when to invoke it
+- **Trigger phrases** — phrases the user says that should activate this skill
+- **Workflow** — numbered steps the agent follows
+- **Examples** — concrete inputs and expected outputs
+- **References** — links to docs, files, or other skills
+
+Keep it focused. One skill = one capability. If it grows beyond ~150 lines,
+consider splitting it.
+
+### 3. Test it
+
+Load the skill into your agent and try the trigger phrases. Check that the
+agent follows the workflow correctly.
+
+### 4. Back it up
+
+```sh
+augy home push
+```
+
+This commits the skill to your home repo so it's available on all your machines.
+
+## SKILL.md template
+
+```markdown
+# Skill: <name>
+
+<One-sentence description of what this skill does.>
+Trigger on: <phrase 1>, <phrase 2>, <phrase 3>.
+
+## Workflow
+
+1. <First step>
+2. <Second step>
+3. <Third step>
+
+## Notes
+
+<!-- Tips, caveats, edge cases -->
+```
+
+## Tips
+
+- **Verb-first steps**: "Run the tests", not "Tests should be run"
+- **Concrete over abstract**: Show exact commands, not just concepts
+- **Fail states**: Tell the agent what to do when things go wrong
+- **Scope**: If you find yourself writing "unless X, in which case Y", that's
+  a second skill