@ichintansoni/skills-master 0.1.8 → 0.1.9

package/README.md

@@ -32,7 +32,7 @@ npx @ichintansoni/skills-master doctor                        # same detection,
 | GitHub Copilot | `.github/instructions/<name>.instructions.md` |
 | AGENTS.md | a sentinel-marked block (your hand-written content is preserved) |
 
-Flags: `--target claude,cursor,copilot,agents|all` · `--with-pairs` (also install the paired code↔design skill) · `--dry-run` · `--overwrite` · `--content <dir>` (use a local skills checkout) · `--ref <git-ref>`.
+Flags: `--target claude,cursor,copilot,agents|all` · `--with-pairs` (also install the paired code↔design skill) · `--dry-run` · `--overwrite` · `--content <dir>` (use a local skills checkout) · `--ref <git-ref>`. An explicit `--target` or `--ref` is remembered in `skills-master.json`, and `--target` widens the configured set rather than replacing it.
 
 Claude Code users can alternatively install via the plugin marketplace:
 
@@ -41,8 +41,45 @@ Claude Code users can alternatively install via the plugin marketplace:
 /plugin install skills-master-apple-code@skills-master
 ```
 
+## Commands
+
+Run `skills-master <command> --help` for the full flag list on any of these.
+
+### Browsing the catalog
+
+| Command | What it does |
+|---|---|
+| `list` | List available skills. `--domain` · `--class` · `--category` · `--platform` · `--json` |
+| `search <query>` | Match a query against names, descriptions, facets, and tags. Spacing, hyphens and case are ignored, so `wear os`, `wear-os` and `WearOS` all find the same skills. `--json` |
+| `view <name>` | Show a skill's metadata and body. `--raw` prints the body alone; `--json` returns metadata *and* body in one document |
+
+### Working in a project
+
+| Command | What it does |
+|---|---|
+| `init` | Detect which tools the project uses and write `skills-master.json`. `--target` · `--commit` · `--ref` · `--force` |
+| `add <names…>` | Install skills by name, category, or class |
+| `update [names…]` | Re-install skills whose **content** changed upstream. Only touches targets a skill is already installed to |
+| `sync [names…]` | Re-emit to match the **current config** — new targets, moved `paths`, deleted files. `--overwrite` · `--prune` · `--dry-run` |
+| `remove <names…>` | Remove installed skills. `--target` removes from one tool only |
+| `status [names…]` | Inventory: versions, targets, and local-edit state. Offline, always exits 0. `--problems` · `--json` |
+| `doctor` | The same detection as `status`, but **exits non-zero** on drift — the CI gate. `--json` |
+
+`update` vs `sync` is the distinction worth knowing: `update` follows *content*, `sync` follows *config*.
+
+### Maintaining the library
+
+These operate on a skills checkout rather than a consuming project.
+
+| Command | What it does |
+|---|---|
+| `lint` | Validate the library: naming, reciprocal `pairs_with`, body caps, tag and source rules |
+| `new <domain/class/category/name>` | Scaffold a skill from the canonical template. `--force` |
+| `registry build` | Regenerate `registry.json`. `--check` fails on drift instead of rewriting |
+| `marketplace build` | Regenerate the Claude plugin marketplace. `--check` fails on drift |
+
 ## How it works
 
 Content lives in the [skills-master repo](https://github.com/iChintanSoni/skills-master) and is fetched on demand; the CLI compiles each skill into your tools' formats and records what it installed in `skills-master.json` + a lockfile so `update`/`remove` stay surgical. Generated files are committed to your repo by default, so teammates' IDEs pick them up without running anything.
 
-MIT licensed. Skill content is original prose that summarizes Apple's publicly documented best practices and links to the canonical docs — it does not reproduce Apple's copyrighted text or sample code.
+MIT licensed. Skill content is original prose that summarizes Apple's and Google's publicly documented best practices and links to the canonical docs — it does not reproduce either vendor's copyrighted text or sample code.

package/dist/bin.js

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 
 // package.json
-var version = "0.1.8";
+var version = "0.1.9";
 
 // src/schema/projectConfig.ts
 import { z } from "zod";
@@ -1128,6 +1128,23 @@ async function addCommand(opts) {
     if (!hadConfig) {
       saveConfig(opts.cwd, { ...cfg, targets });
       log.info("Wrote skills-master.json.");
+    } else {
+      const merged = [.../* @__PURE__ */ new Set([...cfg.targets, ...opts.targets ?? []])].sort();
+      const targetsChanged = opts.targets?.length != null && merged.join() !== [...cfg.targets].sort().join();
+      const refChanged = opts.ref != null && opts.ref !== cfg.contentRef;
+      if (targetsChanged || refChanged) {
+        const next = {
+          ...cfg,
+          targets: targetsChanged ? merged : cfg.targets,
+          contentRef: refChanged ? opts.ref : cfg.contentRef
+        };
+        saveConfig(opts.cwd, next);
+        const what = [
+          targetsChanged ? `targets: ${next.targets.join(", ")}` : null,
+          refChanged ? `ref: ${next.contentRef}` : null
+        ].filter(Boolean);
+        log.info(`Updated skills-master.json (${what.join(", ")}).`);
+      }
     }
     if (!cfg.commit) {
       ensureGitignored(
@@ -1306,16 +1323,34 @@ function doctorCommand(opts) {
   const problems = [];
   const note = (msg) => problems.push(msg);
   const cfg = loadConfig(opts.cwd);
-  if (!cfg) {
-    log.warn("No skills-master.json found \u2014 run `skills-master init`.");
-  } else {
-    log.info(`Config targets: ${cfg.targets.length ? cfg.targets.join(", ") : "(auto-detect)"}`);
-  }
   const lock = loadLockfile(opts.cwd);
   const diagnoses = diagnoseInstalled(opts.cwd, lock);
+  const emit = (report) => {
+    if (!opts.json) return report;
+    log.plain(
+      JSON.stringify(
+        {
+          ok: report.ok,
+          problems: report.problems,
+          skills: diagnoses,
+          configuredTargets: cfg?.targets ?? []
+        },
+        null,
+        2
+      )
+    );
+    return report;
+  };
+  if (!opts.json) {
+    if (!cfg) {
+      log.warn("No skills-master.json found \u2014 run `skills-master init`.");
+    } else {
+      log.info(`Config targets: ${cfg.targets.length ? cfg.targets.join(", ") : "(auto-detect)"}`);
+    }
+  }
   if (diagnoses.length === 0) {
-    log.info("No skills installed.");
-    return { problems, ok: true };
+    if (!opts.json) log.info("No skills installed.");
+    return emit({ problems, ok: true });
   }
   for (const skill of diagnoses) {
     for (const t of skill.targets) {
@@ -1332,14 +1367,16 @@ function doctorCommand(opts) {
       }
     }
   }
-  if (problems.length === 0) {
-    log.success(`All ${diagnoses.length} installed skill(s) look healthy.`);
-  } else {
-    for (const p of problems) log.warn(p);
-    log.plain(`
+  if (!opts.json) {
+    if (problems.length === 0) {
+      log.success(`All ${diagnoses.length} installed skill(s) look healthy.`);
+    } else {
+      for (const p of problems) log.warn(p);
+      log.plain(`
 ${problems.length} problem(s) found.`);
+    }
   }
-  return { problems, ok: problems.length === 0 };
+  return emit({ problems, ok: problems.length === 0 });
 }
 
 // src/commands/status.ts
@@ -1596,6 +1633,10 @@ async function searchCommand(opts) {
       [s.name, s.description, s.domain, s.category, s.class, ...s.tags].join(" ")
     ).includes(q)
   );
+  if (opts.json) {
+    log.plain(JSON.stringify(hits, null, 2));
+    return hits;
+  }
   if (hits.length === 0) {
     log.info(`No matches for "${opts.query}".`);
     return hits;
@@ -1612,6 +1653,24 @@ async function viewCommand(opts) {
   const content = await resolveContent({ content: opts.content, ref: opts.ref, cwd: opts.cwd });
   const skill = content.loadSkill(opts.name);
   const xm = skill.frontmatter["x-skills-master"];
+  if (opts.json) {
+    log.plain(
+      JSON.stringify(
+        {
+          name: skill.name,
+          description: skill.frontmatter.description,
+          globs: skill.frontmatter.globs ?? [],
+          tags: skill.frontmatter.tags ?? [],
+          ...xm,
+          resources: Object.entries(skill.resources).filter(([, v]) => v).map(([k]) => k),
+          body: skill.body
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
   if (opts.raw) {
     log.plain(skill.body);
     return;
@@ -2118,15 +2177,24 @@ program.command("list").description("List available skills").option("--domain <d
     })
   )
 );
-program.command("search <query>").description("Search skills by name, description, tags").option("--content <dir>", "local skills directory").option("--ref <ref>", "content git ref (tag/branch/sha)").action(
-  (query, opts) => run(() => searchCommand({ cwd: process.cwd(), query, content: opts.content, ref: opts.ref }))
+program.command("search <query>").description("Search skills by name, description, tags").option("--content <dir>", "local skills directory").option("--ref <ref>", "content git ref (tag/branch/sha)").option("--json", "machine-readable output").action(
+  (query, opts) => run(
+    () => searchCommand({
+      cwd: process.cwd(),
+      query,
+      content: opts.content,
+      ref: opts.ref,
+      json: opts.json
+    })
+  )
 );
-program.command("view <name>").description("Show a skill's metadata and body").option("--raw", "print the raw SKILL.md body").option("--content <dir>", "local skills directory").option("--ref <ref>", "content git ref (tag/branch/sha)").action(
+program.command("view <name>").description("Show a skill's metadata and body").option("--raw", "print the raw SKILL.md body").option("--content <dir>", "local skills directory").option("--ref <ref>", "content git ref (tag/branch/sha)").option("--json", "machine-readable output (metadata plus body)").action(
   (name, opts) => run(
     () => viewCommand({
       cwd: process.cwd(),
       name,
       raw: opts.raw,
+      json: opts.json,
       content: opts.content,
       ref: opts.ref
     })
@@ -2191,7 +2259,7 @@ program.command("status").description("Show installed skills: versions, targets,
     })
   )
 );
-program.command("doctor").description("Check installed skills for drift and missing files").action(() => run(() => doctorCommand({ cwd: process.cwd() }).ok, true));
+program.command("doctor").description("Check installed skills for drift and missing files").option("--json", "machine-readable output").action((opts) => run(() => doctorCommand({ cwd: process.cwd(), json: opts.json }).ok, true));
 program.command("lint").description("Validate the skill library (maintainer command)").option("--content <dir>", "local skills directory").action((opts) => run(() => lintCommand({ cwd: process.cwd(), content: opts.content }), true));
 program.command("new <spec>").description("Scaffold a new skill: domain/class/category/name (maintainer command)").option("--content <dir>", "local skills directory").option("--force", "overwrite an existing skill directory").action(
   (spec, opts) => run(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ichintansoni/skills-master",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Install tool-agnostic Apple & Android development skills into any AI coding tool (Claude Code, Cursor, Copilot, AGENTS.md).",
   "keywords": [
     "skills",