anyclaude-sdk 0.4.1 → 0.4.3

package/README.md

@@ -277,6 +277,28 @@ await fs.writeFile('/app/index.ts', 'export const x = 1')
 const workspace = composeWorkspace(fs, new NoopCommandExecutor())
 ```
 
+## Skills (programmatic)
+
+Declare reusable prompt-skills inline — each becomes a `/name` slash command and is invokable by the agent through the `skill` tool. `$ARGUMENTS` is substituted at call time:
+
+```ts
+import { query, defineSkill } from 'anyclaude-sdk'
+
+query({
+  prompt, workspace, llm,
+  skills: [
+    defineSkill({
+      name: 'changelog',
+      description: 'Summarize git changes into a changelog entry',
+      instructions: 'Write a concise changelog entry for: $ARGUMENTS',
+      argumentHint: '<since>',
+    }),
+  ],
+})
+```
+
+You can also pass plain `Skill` objects, or `skills: true` to load `.claude/skills/*.md` from the workspace.
+
 ## Serverless & the "survivor"
 
 Run `query()` in a serverless function and stream `SDKMessage`s to the browser. For runs longer than the platform's time cap, checkpoint at a turn boundary and continue transparently in a fresh invocation:

package/dist/agent.js

@@ -12,7 +12,7 @@ import { ALL_CLAUDE_CODE_TOOLS, toolByName, toolDefs } from './tools/index.js';
 import { task as taskTool } from './tools/task.js';
 import { askUserQuestion } from './tools/ask_user.js';
 import { loadMcpServers } from './mcp/index.js';
-import { runSlashCommand } from './commands/index.js';
+import { runSlashCommand, BUILTIN_COMMANDS } from './commands/index.js';
 import { BackgroundTaskManager, BACKGROUND_TOOLS } from './background/index.js';
 import { Mailbox, TaskBoard, TEAM_TOOLS, TEAM_DISPATCH_TOOLS, coordinatorPrompt } from './team/index.js';
 import { MEMORY_TOOLS } from './memory/index.js';
@@ -395,9 +395,9 @@ export async function* runAgent(options) {
         mcp_servers: mcpStatuses,
         model: model ?? 'unknown',
         permissionMode,
-        slash_commands: [],
+        slash_commands: [...new Set([...BUILTIN_COMMANDS, ...allCommands].map((c) => c.name.replace(/^\//, '')))],
         output_style: 'default',
-        skills: [],
+        skills: skills.map((s) => s.name),
         agents: agents ? Object.keys(agents) : undefined,
         uuid: uuid(),
         session_id: sessionId,

package/dist/skills/define.d.ts

@@ -0,0 +1,24 @@
+import type { Skill } from './types.js';
+export interface DefineSkillSpec {
+    /** Skill name — used as the slash-command name and the `skill` tool lookup key. */
+    name: string;
+    /** One-line description of what the skill does (shown to the model + in /help). */
+    description: string;
+    /** The skill's instructions / prompt template. `$ARGUMENTS` is substituted at call time. */
+    instructions: string;
+    /** Optional argument hint, e.g. "<file>" or "<topic>". */
+    argumentHint?: string;
+}
+/**
+ * Define a skill programmatically:
+ *
+ *   query({ skills: [defineSkill({
+ *     name: 'changelog',
+ *     description: 'Summarize git changes into a changelog entry',
+ *     instructions: 'Write a concise changelog entry for: $ARGUMENTS',
+ *   })] })
+ *
+ * It is registered as a `/changelog` slash command and is invokable by the agent
+ * through the `skill` tool. (You can also pass plain `Skill` objects directly.)
+ */
+export declare function defineSkill(spec: DefineSkillSpec): Skill;

package/dist/skills/define.js

@@ -0,0 +1,29 @@
+/**
+ * Define a skill programmatically:
+ *
+ *   query({ skills: [defineSkill({
+ *     name: 'changelog',
+ *     description: 'Summarize git changes into a changelog entry',
+ *     instructions: 'Write a concise changelog entry for: $ARGUMENTS',
+ *   })] })
+ *
+ * It is registered as a `/changelog` slash command and is invokable by the agent
+ * through the `skill` tool. (You can also pass plain `Skill` objects directly.)
+ */
+export function defineSkill(spec) {
+    const name = String(spec.name ?? '').trim();
+    if (!name)
+        throw new Error('defineSkill: `name` is required.');
+    if (!/^[A-Za-z0-9][\w:-]*$/.test(name)) {
+        throw new Error(`defineSkill: invalid name "${name}" (use letters, digits, _ - :).`);
+    }
+    const instructions = String(spec.instructions ?? '');
+    if (!instructions.trim())
+        throw new Error(`defineSkill("${name}"): \`instructions\` is required.`);
+    return {
+        name,
+        description: String(spec.description ?? '').trim(),
+        body: instructions,
+        ...(spec.argumentHint ? { argumentHint: String(spec.argumentHint) } : {}),
+    };
+}

package/dist/skills/index.d.ts

@@ -2,3 +2,4 @@ export type { Skill } from './types.js';
 export { parseSkill } from './parse.js';
 export { loadSkillsFromFs, skillsToCommands, applySkillArgs } from './load.js';
 export { skill } from './tool.js';
+export { defineSkill, type DefineSkillSpec } from './define.js';

package/dist/skills/index.js

@@ -3,3 +3,4 @@
 export { parseSkill } from './parse.js';
 export { loadSkillsFromFs, skillsToCommands, applySkillArgs } from './load.js';
 export { skill } from './tool.js';
+export { defineSkill } from './define.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyclaude-sdk",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Standalone, browser-compatible SDK providing Claude Code agent capabilities (tools, tool loop, multi-turn, MCP, sub-agents, sessions) against any OpenAI/Anthropic-compatible LLM endpoint. Runs in the browser (WebContainer), Node, and Bun — no backend required.",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,6 +14,8 @@
     "./fs": { "types": "./dist/fs/index.d.ts", "import": "./dist/fs/index.js" },
     "./llm": { "types": "./dist/llm/index.d.ts", "import": "./dist/llm/index.js" },
     "./tools": { "types": "./dist/tools/index.d.ts", "import": "./dist/tools/index.js" },
+    "./session": { "types": "./dist/session/index.d.ts", "import": "./dist/session/index.js" },
+    "./memory": { "types": "./dist/memory/index.d.ts", "import": "./dist/memory/index.js" },
     "./package.json": "./package.json"
   },
   "sideEffects": false,