argsbarg 3.1.0 → 3.3.0

package/src/builtins/completion-bash.ts

@@ -5,7 +5,6 @@ import {
   identToken,
   kHelpLong,
   kHelpShort,
-  kSchemaLong,
   mainName,
 } from "./shell-helpers.ts";
 
@@ -17,9 +16,6 @@ function emitConsumeLong(ident: string, scopes: ScopeRec[]): string {
     o += "    " + i + ")\n";
     o += "      case $w in\n";
     o += "        " + kHelpLong + "|${kHelpLong}=*|${kHelpShort}) echo 1 ;;\n".replace(/\$\{kHelpLong\}/g, kHelpLong).replace(/\$\{kHelpShort\}/g, kHelpShort);
-    if (sc.path === "") {
-      o += "        " + kSchemaLong + ") echo 1 ;;\n";
-    }
     for (const op of sc.opts) {
       const base = "--" + op.name;
       if (op.kind === "presence") {
@@ -107,7 +103,7 @@ function emitSimulate(ident: string): string {
   o += "  local i=1 sid=0 w steps next\n";
   o += "  while (( i < COMP_CWORD )); do\n";
   o += "    w=\"${COMP_WORDS[i]}\"\n";
-  o += "    if [[ $w == " + kHelpShort + " || $w == " + kHelpLong + " || $w == " + kSchemaLong + " ]]; then\n";
+  o += "    if [[ $w == " + kHelpShort + " || $w == " + kHelpLong + " ]]; then\n";
   o += "      ((i++)); continue\n";
   o += "    fi\n";
   o += "    if [[ $w == --* ]]; then\n";
@@ -209,9 +205,6 @@ export function completionBashScript(schema: CliRouter): string {
   for (const [i, sc] of scopes.entries()) {
     out += "A_" + ident + "_" + i + "_opts=()\n";
     out += "A_" + ident + "_" + i + "_opts+=('" + kHelpLong + "' '" + kHelpShort + "')\n";
-    if (sc.path === "") {
-      out += "A_" + ident + "_" + i + "_opts+=('" + kSchemaLong + "')\n";
-    }
     for (const o of sc.opts) {
       out += "A_" + ident + "_" + i + "_opts+=('--" + o.name + "')\n";
       if (o.shortName) {

package/src/builtins/completion-fish.ts

@@ -5,8 +5,6 @@ import {
   identToken,
   kHelpLong,
   kHelpShort,
-  kSchemaDesc,
-  kSchemaLong,
 } from "./shell-helpers.ts";
 
 function scopeCondition(ident: string, scopeIndex: number, path: string): string {
@@ -43,9 +41,6 @@ export function completionFishScript(schema: CliRouter): string {
     }
 
     out += `complete -c ${app} -n '${cond}' -s h -l help -d '${escFishSingleQuoted("Show help for this command.")}'\n`;
-    if (sc.path === "") {
-      out += `complete -c ${app} -n '${cond}' -l schema -d '${escFishSingleQuoted(kSchemaDesc)}'\n`;
-    }
 
     for (const op of sc.opts) {
       if (op.kind === CliOptionKind.Presence) {

package/src/builtins/completion-zsh.ts

@@ -5,8 +5,6 @@ import {
   identToken,
   kHelpLong,
   kHelpShort,
-  kSchemaDesc,
-  kSchemaLong,
   mainName,
 } from "./shell-helpers.ts";
 
@@ -16,9 +14,6 @@ function emitScopeArraysZsh(ident: string, scopes: ScopeRec[]): string {
     out += "typeset -g A_" + ident + "_" + i + "_opts\n";
     out += "A_" + ident + "_" + i + "_opts=(";
     out += "'" + escShellSingleQuoted(kHelpLong) + ":" + escShellSingleQuoted("Show help for this command.") + "' '" + escShellSingleQuoted(kHelpShort) + ":" + escShellSingleQuoted("Show help for this command.") + "'";
-    if (sc.path === "") {
-      out += " '" + escShellSingleQuoted(kSchemaLong) + ":" + escShellSingleQuoted(kSchemaDesc) + "'";
-    }
     for (const o of sc.opts) {
       out += " '" + escShellSingleQuoted("--" + o.name) + ":" + escShellSingleQuoted(o.description) + "'";
       if (o.shortName) {
@@ -47,9 +42,6 @@ function emitConsumeLongZsh(ident: string, scopes: ScopeRec[]): string {
     o += "    " + i + ")\n";
     o += "      case $w in\n";
     o += "        " + kHelpLong + "|${kHelpLong}=*|${kHelpShort}) echo 1 ;;\n".replace(/\$\{kHelpLong\}/g, kHelpLong).replace(/\$\{kHelpShort\}/g, kHelpShort);
-    if (sc.path === "") {
-      o += "        " + kSchemaLong + ") echo 1 ;;\n";
-    }
     for (const op of sc.opts) {
       const base = "--" + op.name;
       if (op.kind === "presence") {
@@ -137,7 +129,7 @@ function emitSimulateZsh(ident: string): string {
   o += "  local i=2 sid=0 w steps next\n";
   o += "  while (( i < CURRENT )); do\n";
   o += "    w=$words[i]\n";
-  o += "    if [[ $w == " + kHelpShort + " || $w == " + kHelpLong + " || $w == " + kSchemaLong + " ]]; then\n";
+  o += "    if [[ $w == " + kHelpShort + " || $w == " + kHelpLong + " ]]; then\n";
   o += "      ((i++)); continue\n";
   o += "    fi\n";
   o += "    if [[ $w == --* ]]; then\n";

package/src/builtins/dispatch.ts

@@ -6,12 +6,14 @@ import { completionFishScript } from "./completion-fish.ts";
 import { completionZshScript } from "./completion-zsh.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
+import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group.ts";
 import { cliPresentationRoot } from "./presentation.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 import { cliMcpServeStdio } from "../mcp.ts";
 import { cliInstall } from "../install/index.ts";
+import { cliUpdate } from "../install/update.ts";
 import type { ParseResult } from "../parse.ts";
 import { ParseKind } from "../parse.ts";
 
@@ -80,6 +82,20 @@ export async function dispatchBuiltin(
     process.exit(0);
   }
 
+  if (pr.path[0] === "update") {
+    if (!caps.update) {
+      process.stderr.write(
+        "update is not enabled. Set install.updateGetLatest on the program root.\n",
+      );
+      process.exit(1);
+    }
+    if (pr.path.length !== 1) {
+      process.stderr.write("Unknown subcommand: update " + pr.path.slice(1).join(" ") + "\n");
+      process.exit(1);
+    }
+    await cliUpdate(program);
+  }
+
   if (pr.path[0] === "install") {
     if (!caps.install) {
       process.stderr.write("install is disabled. Remove install.enabled: false from the program root.\n");
@@ -127,6 +143,17 @@ export function builtinInterceptRoot(
     };
   }
 
+  if (first === "update" && caps.update) {
+    return {
+      parseRoot: {
+        key: program.key,
+        description: program.description,
+        commands: [cliBuiltinUpdateCommand(program)],
+      },
+      isLeafCompletionIntercept: false,
+    };
+  }
+
   if (first === "mcp" && caps.mcp) {
     return {
       parseRoot: {

package/src/builtins/export.ts

@@ -3,6 +3,7 @@ import type { CliFallbackMode, CliOption, CliPositional, CliProgram } from "../t
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
+import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 
@@ -51,6 +52,9 @@ export function exportPresentationBuiltins(program: CliProgram, caps?: CliCapabi
   if (resolved.install) {
     builtins.push(exportBuiltinNode(cliBuiltinInstallCommand(program)));
   }
+  if (resolved.update) {
+    builtins.push(exportBuiltinNode(cliBuiltinUpdateCommand(program)));
+  }
   const docsGroup = cliBuiltinDocsGroupIfEnabled(program);
   if (docsGroup) {
     builtins.push(exportBuiltinNode(docsGroup));

package/src/builtins/install.ts

@@ -26,10 +26,15 @@ export function installBuiltinOptions(root: CliProgram): CliOption[] {
       kind: CliOptionKind.Presence,
     },
     {
-      name: "update",
-      description: "Update only artifacts already installed (always includes the binary).",
+      name: "reinstall",
+      description: "Reinstall artifacts already on disk (always includes the binary).",
       kind: CliOptionKind.Presence,
     },
+    {
+      name: "from",
+      description: "Binary to copy (default: running executable). Used with --reinstall.",
+      kind: CliOptionKind.String,
+    },
     {
       name: "status",
       description: "Print what is currently installed (read-only).",
@@ -87,7 +92,8 @@ export function cliBuiltinInstallCommand(root: CliProgram): CliLeaf {
       "First-time setup:\n" +
       `  {app} install --all --yes\n\n` +
       "Refresh after upgrading:\n" +
-      `  {app} install --update\n\n` +
+      `  {app} install --reinstall\n` +
+      `  {app} update\n\n` +
       "See what is installed:\n" +
       `  {app} install --status\n\n` +
       "Remove everything:\n" +

package/src/builtins/presentation.ts

@@ -5,6 +5,7 @@ import { isCliLeaf, isCliRouter } from "../types.ts";
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
+import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 
@@ -17,6 +18,9 @@ export function presentationBuiltins(program: CliProgram, caps: CliCapabilities)
   if (caps.install) {
     builtins.push(cliBuiltinInstallCommand(program));
   }
+  if (caps.update) {
+    builtins.push(cliBuiltinUpdateCommand(program));
+  }
   const docsGroup = cliBuiltinDocsGroupIfEnabled(program);
   if (docsGroup) {
     builtins.push(docsGroup);

package/src/builtins/shell-helpers.ts

@@ -20,5 +20,3 @@ export function mainName(schemaName: string): string {
 
 export const kHelpLong = "--help";
 export const kHelpShort = "-h";
-export const kSchemaLong = "--schema";
-export const kSchemaDesc = "Print the full command tree as JSON.";

package/src/builtins/update.ts

@@ -0,0 +1,14 @@
+import type { CliLeaf, CliProgram } from "../types.ts";
+import { cliUpdate } from "../install/update.ts";
+
+/** Built-in `update` command (enabled when `install.updateGetLatest` is set). */
+export function cliBuiltinUpdateCommand(program: CliProgram): CliLeaf {
+  return {
+    key: "update",
+    description: "Download and install the latest release.",
+    mcpTool: { enabled: false },
+    handler: async () => {
+      await cliUpdate(program);
+    },
+  };
+}

package/src/capabilities.ts

@@ -11,15 +11,18 @@ export interface CliCapabilities {
   mcp: boolean;
   install: boolean;
   docs: boolean;
+  update: boolean;
 }
 
 /** Resolves which capabilities are enabled for a program. */
 export function resolveCapabilities(program: CliProgram): CliCapabilities {
+  const install = program.install?.enabled !== false;
   return {
     completion: true,
     mcp: program.mcpServer?.enabled === true,
-    install: program.install?.enabled !== false,
+    install,
     docs: program.docs?.enabled === true,
+    update: install && typeof program.install?.updateGetLatest === "function",
   };
 }
 
@@ -29,6 +32,9 @@ export function reservedCommandNames(caps: CliCapabilities): string[] {
   if (caps.install) {
     names.push("install");
   }
+  if (caps.update) {
+    names.push("update");
+  }
   if (caps.docs) {
     names.push("docs");
   }

package/src/docs/api-guide.test.ts

@@ -0,0 +1,55 @@
+import { expect, test } from "bun:test";
+import type { CliProgram } from "../types.ts";
+import { CliOptionKind } from "../types.ts";
+import { generateApiGuide } from "./api-guide.ts";
+import { cliSchemaExport } from "../schema.ts";
+
+const nestedFixture: CliProgram = {
+  key: "nested.ts",
+  version: "1.0.0",
+  description: "Nested groups demo.",
+  docs: { enabled: true, topics: { readme: { text: "# readme\n" } } },
+  commands: [
+    {
+      key: "stat",
+      description: "File metadata.",
+      commands: [
+        {
+          key: "owner",
+          description: "Ownership helpers.",
+          commands: [
+            {
+              key: "lookup",
+              description: "Resolve owner info.",
+              options: [
+                {
+                  name: "user-name",
+                  description: "User to look up.",
+                  kind: CliOptionKind.String,
+                  shortName: "u",
+                },
+              ],
+              positionals: [
+                {
+                  name: "path",
+                  description: "File or directory.",
+                  kind: CliOptionKind.String,
+                },
+              ],
+              handler: () => {},
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+
+test("generateApiGuide covers the same command keys as cliSchemaExport", () => {
+  const md = generateApiGuide(nestedFixture);
+  const schema = cliSchemaExport(nestedFixture);
+  expect(md).toContain("`nested.ts stat owner lookup`");
+  expect(md).toContain("`--user-name` (`-u`)");
+  expect(md).toContain("`<path>`");
+  expect(schema.commands?.map((c) => c.key)).toEqual(["stat"]);
+});

package/src/docs/api-guide.ts

@@ -0,0 +1,129 @@
+import type { CliSchemaExport } from "../builtins/export.ts";
+import { cliPositionalLabel } from "../help.ts";
+import { cliSchemaExport } from "../schema.ts";
+import type { CliOption, CliPositional, CliProgram } from "../types.ts";
+import { CliFallbackMode, CliOptionKind } from "../types.ts";
+
+/** CLI invocation path as a single string (`myapp stat owner lookup`). */
+function commandPath(rootKey: string, path: string[]): string {
+  if (path.length === 0) {
+    return rootKey;
+  }
+  return [rootKey, ...path].join(" ");
+}
+
+/** Human-readable option type for API tables. */
+function optionType(opt: CliOption): string {
+  if (opt.kind === CliOptionKind.Presence) {
+    return "flag";
+  }
+  if (opt.kind === CliOptionKind.Enum) {
+    return `enum (\`${(opt.choices ?? []).join("`, `")}\`)`;
+  }
+  return opt.kind;
+}
+
+/** Markdown table cell for one option flag. */
+function optionLabel(opt: CliOption): string {
+  const long = `\`--${opt.name}\``;
+  const short = opt.shortName ? ` (\`-${opt.shortName}\`)` : "";
+  return `${long}${short}`;
+}
+
+/** One options table row. */
+function formatOptionRow(opt: CliOption): string {
+  const req = opt.required ? "required" : "optional";
+  return `| ${optionLabel(opt)} | ${optionType(opt)} | ${req} | ${opt.description} |`;
+}
+
+/** One positionals table row. */
+function formatPositionalRow(p: CliPositional): string {
+  const label = cliPositionalLabel(p, false);
+  const req = (p.argMin ?? 1) > 0 ? "required" : "optional";
+  return `| \`${label}\` | ${p.kind} | ${req} | ${p.description} |`;
+}
+
+/** Fallback routing note when present on a router node. */
+function fallbackLine(node: CliSchemaExport): string | null {
+  if (node.fallbackCommand === undefined) {
+    return null;
+  }
+  const mode = node.fallbackMode ?? CliFallbackMode.MissingOnly;
+  return `**Default subcommand:** \`${node.fallbackCommand}\` (\`${mode}\`)`;
+}
+
+/** Renders one command node and recurses into subcommands. */
+function renderCommandNode(
+  rootKey: string,
+  path: string[],
+  node: CliSchemaExport,
+  lines: string[],
+): void {
+  const level = Math.min(path.length + 2, 6);
+  const heading = "#".repeat(level);
+  const cmd = commandPath(rootKey, path);
+
+  lines.push(`${heading} \`${cmd}\``, "", node.description, "");
+
+  if (node.notes) {
+    lines.push(`> ${node.notes}`, "");
+  }
+
+  const fb = fallbackLine(node);
+  if (fb) {
+    lines.push(fb, "");
+  }
+
+  if ((node.options ?? []).length > 0) {
+    lines.push("#### Options", "");
+    lines.push("| Option | Type | Required | Description |");
+    lines.push("| --- | --- | --- | --- |");
+    for (const opt of node.options!) {
+      lines.push(formatOptionRow(opt));
+    }
+    lines.push("");
+  }
+
+  if ((node.positionals ?? []).length > 0) {
+    lines.push("#### Positionals", "");
+    lines.push("| Argument | Type | Required | Description |");
+    lines.push("| --- | --- | --- | --- |");
+    for (const p of node.positionals!) {
+      lines.push(formatPositionalRow(p));
+    }
+    lines.push("");
+  }
+
+  const children = node.commands ?? [];
+  if (children.length > 0) {
+    lines.push("#### Subcommands", "");
+    for (const child of children) {
+      lines.push(`- \`${child.key}\` — ${child.description}`);
+    }
+    lines.push("");
+  }
+
+  for (const child of children) {
+    renderCommandNode(rootKey, [...path, child.key], child, lines);
+  }
+}
+
+/** Generates markdown API reference from the same export as `docs schema`. */
+export function generateApiGuide(program: CliProgram): string {
+  const schema = cliSchemaExport(program);
+  const lines: string[] = [
+    `# ${program.key} — CLI API reference`,
+    "",
+    schema.description,
+    "",
+    `Machine-readable export: \`${program.key} docs schema\``,
+    "",
+  ];
+
+  if (schema.notes) {
+    lines.push(`> ${schema.notes}`, "");
+  }
+
+  renderCommandNode(program.key, [], schema, lines);
+  return `${lines.join("\n").trimEnd()}\n`;
+}

package/src/docs/builtin.ts

@@ -37,6 +37,9 @@ export function cliBuiltinDocsGroup(program: CliProgram): CliRouter {
   }
 
   leaves.push(
+    docsLeaf(program, "schema", "Print the full command tree as JSON."),
+    docsLeaf(program, "api", "Print the command tree as markdown."),
+    docsLeaf(program, "skill", "Print generated Cursor SKILL.md content."),
     docsLeaf(program, "all", "Print all bundled documentation combined."),
   );
 

package/src/docs/docs.test.ts

@@ -46,7 +46,13 @@ test("docs reserved when enabled", () => {
 
 test("docs rejects reserved topic keys", () => {
   const root = docsFixture();
-  root.docs!.topics.mcp = { text: "nope" };
+  root.docs!.topics.schema = { text: "nope" };
+  expect(() => cliValidateProgram(root)).toThrow(/reserved/);
+  delete root.docs!.topics.schema;
+  root.docs!.topics.skill = { text: "nope" };
+  expect(() => cliValidateProgram(root)).toThrow(/reserved/);
+  delete root.docs!.topics.skill;
+  root.docs!.topics.api = { text: "nope" };
   expect(() => cliValidateProgram(root)).toThrow(/reserved/);
 });
 
@@ -109,10 +115,50 @@ test("presentation includes docs subtree", () => {
   );
 });
 
+test("docs schema prints JSON", async () => {
+  const result = await cliInvoke(docsFixture(), ["docs", "schema"]);
+  expect(result.exitCode).toBe(0);
+  const schema = JSON.parse(result.stdout);
+  expect(schema.key).toBe("myapp");
+  expect(schema.commands.some((c: { key: string }) => c.key === "run")).toBe(true);
+});
+
+test("docs api prints markdown reference", async () => {
+  const result = await cliInvoke(docsFixture(), ["docs", "api"]);
+  expect(result.exitCode).toBe(0);
+  expect(result.stdout).toContain("# myapp — CLI API reference");
+  expect(result.stdout).toContain("## `myapp run`");
+  expect(result.stdout).toContain("Run something.");
+  expect(result.stdout).toContain("myapp docs schema");
+});
+
+test("docs skill prints Cursor SKILL.md", async () => {
+  const result = await cliInvoke(docsFixture(), ["docs", "skill"]);
+  expect(result.exitCode).toBe(0);
+  expect(result.stdout).toContain("---");
+  expect(result.stdout).toContain("name: myapp");
+  expect(result.stdout).toContain("## Commands");
+  expect(result.stdout).not.toContain("mcp.json");
+});
+
+test("presentation includes docs schema and skill", () => {
+  const presentation = cliPresentationRoot(docsFixture());
+  const docsNode = presentation.commands.find((c) => c.key === "docs");
+  expect(docsNode && "commands" in docsNode).toBe(true);
+  if (docsNode && "commands" in docsNode) {
+    expect(docsNode.commands.some((c) => c.key === "schema")).toBe(true);
+    expect(docsNode.commands.some((c) => c.key === "api")).toBe(true);
+    expect(docsNode.commands.some((c) => c.key === "skill")).toBe(true);
+  }
+});
+
 test("completions offer docs subcommands", () => {
   const bash = completionBashScript(cliPresentationRoot(docsFixture()));
   expect(bash).toContain("docs) echo");
   expect(bash).toContain("readme) echo");
+  expect(bash).toContain("schema) echo");
+  expect(bash).toContain("api) echo");
+  expect(bash).toContain("skill) echo");
 });
 
 test("generateMcpGuide includes schema URI", () => {

package/src/docs/mcp-guide.ts

@@ -84,7 +84,7 @@ export function generateMcpGuide(root: CliProgram): string {
     "|-----------|---------|",
     "| `tools/list` | Callable tools for exposed leaf commands |",
     "| `tools/call` | Runs handlers headlessly; JSON stdout becomes `structuredContent` when valid |",
-    `| Schema resource | \`${schemaUri}\` — same JSON as \`${root.key} --schema\` |`,
+    `| Schema resource | \`${schemaUri}\` — same JSON as \`${root.key} docs schema\` |`,
     "",
     "## Exposed tools",
     "",
@@ -103,13 +103,13 @@ export function generateMcpGuide(root: CliProgram): string {
     "## Tool arguments",
     "",
     "Arguments are a flat JSON object keyed by long option and positional names (hyphenated option names are valid keys).",
-    `See \`${root.key} --schema\` or the schema resource for per-tool shapes.`,
+    `See \`${root.key} docs schema\` or the schema resource for per-tool shapes.`,
     "",
     "Varargs positionals accept a JSON array or a comma-separated string.",
     "",
     "## Protocol",
     "",
-    "Stdio NDJSON JSON-RPC. Help and `--schema` are not available through tool calls.",
+    "Stdio NDJSON JSON-RPC. Help and `docs schema` are not available through tool calls.",
     `Run \`${root.key} docs\` for bundled user documentation.`,
     "",
   );

package/src/docs/resolve.ts

@@ -1,8 +1,11 @@
 import type { CliDocsConfig, CliProgram } from "../types.ts";
+import { cliSchemaJson } from "../schema.ts";
+import { generateSkillBundle } from "../skill/generate.ts";
+import { generateApiGuide } from "./api-guide.ts";
 import { generateMcpGuide } from "./mcp-guide.ts";
 
 /** Built-in docs subcommand keys not allowed in `docs.topics`. */
-export const DOCS_BUILTIN_TOPIC_KEYS = ["mcp", "all"] as const;
+export const DOCS_BUILTIN_TOPIC_KEYS = ["mcp", "all", "schema", "api", "skill"] as const;
 
 export type DocsBuiltinTopicKey = (typeof DOCS_BUILTIN_TOPIC_KEYS)[number];
 
@@ -81,8 +84,36 @@ export function combineAllDocs(program: CliProgram): string {
     .join("\n\n---\n\n");
 }
 
+/** Writes CLI schema JSON to stdout (`docs schema`). */
+export function printDocsSchema(program: CliProgram): void {
+  process.stdout.write(cliSchemaJson(program));
+}
+
+/** Writes markdown API reference to stdout (`docs api`). */
+export function printDocsApi(program: CliProgram): void {
+  process.stdout.write(generateApiGuide(program));
+}
+
+/** Writes generated Cursor SKILL.md to stdout (`docs skill`). */
+export function printDocsSkill(program: CliProgram): void {
+  const bundle = generateSkillBundle(program, "cursor");
+  process.stdout.write(`${bundle.skillMd}\n`);
+}
+
 /** Writes one docs topic (or `all`) to stdout. */
 export function printDocsTopic(program: CliProgram, topic: string): void {
+  if (topic === "schema") {
+    printDocsSchema(program);
+    return;
+  }
+  if (topic === "api") {
+    printDocsApi(program);
+    return;
+  }
+  if (topic === "skill") {
+    printDocsSkill(program);
+    return;
+  }
   const content = topic === "all" ? combineAllDocs(program) : docsTopicText(program, topic);
   process.stdout.write(`${content}\n`);
 }