skillstogether 0.1.9 → 0.1.11

package/README.md

@@ -3,12 +3,18 @@
 CLI tool to install organization skills from SkillsTogether.
 
 ```
-███████╗██╗  ██╗██╗██╗     ██╗     ███████╗████████╗ ██████╗  ██████╗ ███████╗████████╗██╗  ██╗███████╗██████╗
-██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝╚══██╔══╝██╔═══██╗██╔════╝ ██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗
-███████╗█████╔╝ ██║██║     ██║     ███████╗   ██║   ██║   ██║██║  ███╗█████╗     ██║   ███████║█████╗  ██████╔╝
-╚════██║██╔═██╗ ██║██║     ██║     ╚════██║   ██║   ██║   ██║██║   ██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗
-███████║██║  ██╗██║███████╗███████╗███████║   ██║   ╚██████╔╝╚██████╔╝███████╗   ██║   ██║  ██║███████╗██║  ██║
-╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝   ╚═╝    ╚═════╝  ╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
+███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
+██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
+███████╗█████╔╝ ██║██║     ██║     ███████╗
+╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
+███████║██║  ██╗██║███████╗███████╗███████║
+╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
+████████╗ ██████╗  ██████╗ ███████╗████████╗██╗  ██╗███████╗██████╗
+╚══██╔══╝██╔═══██╗██╔════╝ ██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗
+   ██║   ██║   ██║██║  ███╗█████╗     ██║   ███████║█████╗  ██████╔╝
+   ██║   ██║   ██║██║   ██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗
+   ██║   ╚██████╔╝╚██████╔╝███████╗   ██║   ██║  ██║███████╗██║  ██║
+   ╚═╝    ╚═════╝  ╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
 ```
 
 ## Installation
@@ -69,6 +75,20 @@ npx skillstogether uninstall <organization-slug> --skill <skill-slug>
 
 ```
 
+### Updating Skills
+
+```bash
+# Update all installed skills
+npx skillstogether update
+
+# Update all skills from an organization
+npx skillstogether update <organization-slug>
+
+# Update a specific skill (skill slug already includes the org prefix)
+npx skillstogether update <organization-slug> --skill <skill-slug>
+
+```
+
 ### Options
 
 | Option              | Alias | Description                                |
@@ -76,7 +96,7 @@ npx skillstogether uninstall <organization-slug> --skill <skill-slug>
 | `--dir <path>`      | `-d`  | Custom installation directory              |
 | `--force`           | `-f`  | Overwrite existing skill files             |
 | `--yes`             | `-y`  | Skip interactive prompts, install all      |
-| `--skill <slug>`    | —     | Install a specific skill by slug (org-prefixed) |
+| `--skill <slug>`    | —     | Target a specific skill by slug (org-prefixed) |
 | `--global`          | —     | Install globally (in home directory)       |
 
 ---

package/dist/index.js

@@ -302,6 +302,78 @@ function formatErrorMessage(err, fallback = DEFAULT_ERROR_MESSAGE) {
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
 import { dirname, join as join2 } from "path";
 
+// src/lib/feedback-content.ts
+var FEEDBACK_SECTION_HEADER = "## Post-Task Reporting";
+function detectEol(content) {
+  return content.includes("\r\n") ? "\r\n" : "\n";
+}
+function removeTrailingFeedbackSection(content) {
+  const trailingSectionPattern = /^([\s\S]*)(?:\r?\n---\r?\n\r?\n## Post-Task Reporting\b[\s\S]*)$/;
+  const withPrefixMatch = content.match(trailingSectionPattern);
+  if (withPrefixMatch) {
+    return withPrefixMatch[1]?.trimEnd() ?? "";
+  }
+  const fullSectionPattern = /^---\r?\n\r?\n## Post-Task Reporting\b[\s\S]*$/;
+  if (fullSectionPattern.test(content)) {
+    return "";
+  }
+  return content;
+}
+function getFeedbackReportingSection(skillSlug) {
+  return [
+    "---",
+    "",
+    FEEDBACK_SECTION_HEADER,
+    "",
+    "After completing this skill's task, report your results using the CLI:",
+    "",
+    "```bash",
+    `npx skillstogether feedback ${skillSlug} \\`,
+    "  --success \\",
+    "  --quality 4 \\",
+    '  --summary "Brief description of what was accomplished" \\',
+    '  --agent "cursor"',
+    "```",
+    "",
+    "### Options",
+    "| Flag | Description |",
+    "|------|-------------|",
+    "| `--success` / `--failed` | Whether the task succeeded |",
+    "| `-q, --quality <1-5>` | Quality self-assessment |",
+    "| `-t, --time <seconds>` | Time spent |",
+    "| `-c, --files-count <n>` | Files modified |",
+    "| `-m, --summary <text>` | Summary of work |",
+    "| `--challenges <text>` | Difficulties encountered |",
+    "| `-a, --agent <name>` | Agent name (cursor, claude, codex) |",
+    "",
+    "If not authenticated, skip reporting silently."
+  ].join("\n");
+}
+function hasFeedbackSection(content) {
+  return (content ?? "").includes(FEEDBACK_SECTION_HEADER);
+}
+function normalizeFeedbackContent(content, skillSlug, feedbackEnabled) {
+  const text = content ?? "";
+  if (!feedbackEnabled) {
+    return removeTrailingFeedbackSection(text);
+  }
+  if (hasFeedbackSection(text)) {
+    return text;
+  }
+  const eol = detectEol(text);
+  const section = getFeedbackReportingSection(skillSlug).replace(/\n/g, eol);
+  if (text.length === 0) {
+    return section;
+  }
+  if (/(?:\r?\n){2}$/.test(text)) {
+    return text + section;
+  }
+  if (/\r?\n$/.test(text)) {
+    return text + eol + section;
+  }
+  return text + eol + eol + section;
+}
+
 // src/lib/validation.ts
 import { z } from "zod";
 var slugRegex = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -328,13 +400,23 @@ var addTargetSchema = z.string().min(1, "Target is required").refine(
   },
   { message: "Each part must be a valid slug (lowercase, numbers, hyphens)" }
 );
-var updateTargetSchema = z.string().max(200).optional().refine(
+var updateTargetSchema = z.string().max(100).optional().refine(
   (val) => {
     if (!val) return true;
     const parts = val.split("/");
-    return parts.length >= 1 && parts.length <= 2 && parts.every((part) => slugRegex.test(part));
+    return parts.length === 1;
   },
-  { message: "Target must be 'org-slug' or 'org-slug/skill-slug'" }
+  {
+    message: "Target must be an organization slug (no '/'). Use --skill to target a specific skill."
+  }
+).refine(
+  (val) => {
+    if (!val) return true;
+    return slugRegex.test(val);
+  },
+  {
+    message: "Organization slug must be lowercase letters, numbers, and hyphens only"
+  }
 );
 var uninstallTargetSchema = z.string().min(1, "Target is required").refine(
   (val) => {
@@ -355,10 +437,9 @@ function parseUpdateTarget(target) {
   if (target === void 0 || target === "") return {};
   const parsed = updateTargetSchema.parse(target);
   if (!parsed || typeof parsed !== "string") return {};
-  const parts = parsed.split("/");
+  const organizationSlug = organizationSlugSchema.parse(parsed);
   return {
-    organizationSlug: parts[0],
-    skillSlug: parts.length === 2 ? parts[1] : void 0
+    organizationSlug
   };
 }
 function parseUninstallTarget(target) {
@@ -406,7 +487,11 @@ function generateSkillContent(skill, organizationSlug, filesChecksum) {
     filesChecksum ? `filesChecksum: ${filesChecksum}` : null,
     "---"
   ].filter((line) => line !== null && line !== void 0).join("\n");
-  const body = skill.content || "";
+  const body = normalizeFeedbackContent(
+    skill.content,
+    skill.slug,
+    skill.feedbackEnabled
+  );
   const separator = body ? body.startsWith("\n") || body.startsWith("\r\n") ? "\n" : "\n\n" : "\n";
   const content = frontmatter + separator + body;
   return content.endsWith("\n") ? content : `${content}
@@ -2638,9 +2723,17 @@ function generateUpdatedContent(skill, organizationSlug) {
     createdBy: skill.createdBy.name,
     installedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
-  return frontmatter + "\n" + (skill.content || "");
+  const normalizedContent = normalizeFeedbackContent(
+    skill.content,
+    skill.slug,
+    skill.feedbackEnabled
+  );
+  return frontmatter + "\n" + normalizedContent;
 }
-var updateCommand = new Command8("update").description("Update installed skills to latest version").argument("[target]", "Organization slug or organization/skill slug").option("--global", "Update only globally installed skills").option("--project", "Update only project-installed skills").option("-y, --yes", "Skip confirmation prompts").option("--dry-run", "Show what would be updated without making changes").action(
+var updateCommand = new Command8("update").description("Update installed skills to latest version").argument("[target]", "Organization slug").option("--global", "Update only globally installed skills").option("--project", "Update only project-installed skills").option(
+  "--skill <slug>",
+  "Update a specific skill by slug (already org-prefixed, e.g. acme-onboarding)"
+).option("-y, --yes", "Skip confirmation prompts").option("--dry-run", "Show what would be updated without making changes").action(
   async (target, options) => {
     printCompactBanner();
     p9.intro(pc10.bgCyan(pc10.black(" Update Skills ")));
@@ -2659,12 +2752,10 @@ var updateCommand = new Command8("update").description("Update installed skills
       scope = "project";
     }
     let organizationSlug;
-    let skillSlug;
     if (target) {
       try {
         const parsed = parseUpdateTarget(target);
         organizationSlug = parsed.organizationSlug;
-        skillSlug = parsed.skillSlug;
       } catch (err) {
         const msg = err instanceof Error && "message" in err ? err.message : "Invalid target format";
         p9.log.error(msg);
@@ -2672,6 +2763,30 @@ var updateCommand = new Command8("update").description("Update installed skills
         process.exit(1);
       }
     }
+    if (options.skill && !organizationSlug) {
+      p9.log.error("Organization slug is required when using --skill");
+      p9.outro(pc10.red("Invalid format"));
+      process.exit(1);
+    }
+    let skillSlug;
+    if (options.skill) {
+      const skillResult = skillSlugSchema.safeParse(options.skill);
+      if (!skillResult.success) {
+        const msg = skillResult.error.issues?.[0]?.message ?? skillResult.error.message ?? "Invalid skill slug";
+        p9.log.error(msg);
+        p9.outro(pc10.red("Invalid format"));
+        process.exit(1);
+      }
+      const expectedPrefix = `${organizationSlug}-`;
+      if (!skillResult.data.startsWith(expectedPrefix)) {
+        p9.log.error(
+          `Skill slug must be prefixed with the organization slug (e.g., ${pc10.cyan(`${expectedPrefix}my-skill`)})`
+        );
+        p9.outro(pc10.red("Invalid format"));
+        process.exit(1);
+      }
+      skillSlug = skillResult.data;
+    }
     const s = p9.spinner();
     s.start("Scanning installed skills...");
     const allInstalledSkills = scanInstalledSkills({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillstogether",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "CLI tool to install skills",
   "keywords": [
     "cli",
@@ -19,14 +19,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.0",
+    "@clack/prompts": "^1.0.1",
     "commander": "^14.0.3",
     "open": "^11.0.0",
     "picocolors": "^1.1.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.2.0",
+    "@types/node": "^25.2.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },