@amitdeshmukh/ax-crew 8.7.1 → 8.7.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [8.7.3] - 2026-03-17
+
+### Added
+- **Supporting example files** bundled with each skill. The postinstall script now copies relevant example `.ts` files into each skill's `examples/` directory. Claude Code can load these on demand for complete runnable references.
+- SKILL.md files now reference local `examples/` paths instead of GitHub URLs, enabling Claude to read examples directly.
+
+### Changed
+- Renamed all skill files from `ax-crew-*` to `axcrew-*` (e.g., `axcrew-ace.md`, `axcrew-mcp.md`). Skill directory names in `.claude/skills/` updated accordingly.
+- Updated version in all skill frontmatter to `8.7.3`.
+
+## [8.7.2] - 2026-03-17
+
+### Fixed
+- Skill install now creates proper directory structure for Claude Code discovery. Each skill gets its own directory with a `SKILL.md` file (e.g., `.claude/skills/ax-crew/SKILL.md`, `.claude/skills/ax-crew-ace/SKILL.md`). Previously installed loose `.md` files in a single directory which Claude Code couldn't discover.
+
 ## [8.7.1] - 2026-03-17
 
 ### Fixed

package/README.md

@@ -1,4 +1,4 @@
-![image](axcrew.png)
+![AxCrew](axcrew.webp)
 
 [![npm version](https://img.shields.io/npm/v/@amitdeshmukh/ax-crew.svg)](https://www.npmjs.com/package/@amitdeshmukh/ax-crew) [![npm downloads](https://img.shields.io/npm/dm/@amitdeshmukh/ax-crew.svg)](https://www.npmjs.com/package/@amitdeshmukh/ax-crew)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@amitdeshmukh/ax-crew",
-  "version": "8.7.1",
+  "version": "8.7.3",
   "description": "Build and launch a crew of AI agents with shared state. Built with axllm.dev",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/install-skills.mjs

@@ -4,35 +4,46 @@
  * Postinstall script: installs ax-crew skill files for Claude Code and Codex.
  * Runs automatically on `npm install @amitdeshmukh/ax-crew`.
  *
- * Skills are installed to the PROJECT directory (not home dir):
- * Claude Code: .claude/skills/ax-crew/   (individual .md files)
- * Codex:       .agents/skills/ax-crew/   (combined SKILL.md)
+ * Claude Code expects: .claude/skills/<skill-name>/SKILL.md
+ * Each skill gets its own directory with SKILL.md + optional examples/ and references/.
  *
- * The project root is determined by walking up from node_modules
- * to find the consuming project's root directory.
+ * Codex expects: .agents/skills/<skill-name>/SKILL.md
+ * One combined skill directory.
  */
 
-import { existsSync, mkdirSync, readdirSync, copyFileSync, readFileSync, writeFileSync } from 'fs';
-import { join, dirname, resolve } from 'path';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
+import { join, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const skillsSource = join(__dirname, '..', 'src', 'skills');
+const examplesSource = join(__dirname, '..', 'examples');
+
+// Mapping: skill name → example files to include
+const SKILL_EXAMPLES = {
+  'axcrew':                ['basic-researcher-writer.ts'],
+  'axcrew-agent-config':   ['providerArgs.ts'],
+  'axcrew-ace':            ['ace-customer-support.ts', 'ace-flight-finder.ts'],
+  'axcrew-code-execution': ['rlm-long-task.ts'],
+  'axcrew-execution-modes':['rlm-long-task.ts', 'rlm-shared-fields.ts'],
+  'axcrew-few-shot':       ['solve-math-problem.ts'],
+  'axcrew-functions':      ['write-post-and-publish-to-wordpress.ts'],
+  'axcrew-mcp':            ['mcp-agent.ts', 'graphjin-database-agent.ts'],
+  'axcrew-metrics':        ['basic-researcher-writer.ts'],
+  'axcrew-patterns':       ['write-post-and-publish-to-wordpress.ts', 'solve-math-problem.ts'],
+  'axcrew-providers':      ['providerArgs.ts', 'search-tweets.ts', 'perplexityDeepSearch.ts'],
+  'axcrew-state':          ['write-post-and-publish-to-wordpress.ts'],
+  'axcrew-streaming':      ['streaming.ts'],
+  'axcrew-sub-agents':     ['basic-researcher-writer.ts', 'rlm-shared-fields.ts'],
+  'axcrew-telemetry':      ['telemetry-demo.ts'],
+  // axcrew-signatures: no examples needed
+};
 
-// Find the project root by walking up from the package's location
-// When installed via npm, we're at <project>/node_modules/@amitdeshmukh/ax-crew/scripts/
-// So project root is 4 levels up. When running locally (dev), use INIT_CWD or cwd.
 function findProjectRoot() {
-  // npm sets INIT_CWD to the directory where `npm install` was run
-  if (process.env.INIT_CWD) {
-    return process.env.INIT_CWD;
-  }
-  // Fallback: walk up from our location past node_modules
-  let dir = resolve(__dirname, '..');
+  if (process.env.INIT_CWD) return process.env.INIT_CWD;
+  let dir = join(__dirname, '..');
   while (dir !== dirname(dir)) {
-    if (existsSync(join(dir, 'node_modules'))) {
-      return dir;
-    }
+    if (existsSync(join(dir, 'node_modules'))) return dir;
     dir = dirname(dir);
   }
   return process.cwd();
@@ -46,19 +57,40 @@ function installSkills() {
 
   const projectRoot = findProjectRoot();
 
-  // Claude Code: individual skill files in project dir
-  const claudeDir = join(projectRoot, '.claude', 'skills', 'ax-crew');
-  try {
-    mkdirSync(claudeDir, { recursive: true });
-    for (const file of skillFiles) {
-      copyFileSync(join(skillsSource, file), join(claudeDir, file));
+  // Claude Code: each skill gets its own directory with SKILL.md + examples/
+  let claudeCount = 0;
+  let exampleCount = 0;
+  for (const file of skillFiles) {
+    const skillName = basename(file, '.md');
+    const skillDir = join(projectRoot, '.claude', 'skills', skillName);
+    try {
+      mkdirSync(skillDir, { recursive: true });
+      const content = readFileSync(join(skillsSource, file), 'utf-8');
+      writeFileSync(join(skillDir, 'SKILL.md'), content);
+      claudeCount++;
+
+      // Copy example files if mapped
+      const examples = SKILL_EXAMPLES[skillName];
+      if (examples && existsSync(examplesSource)) {
+        const exDir = join(skillDir, 'examples');
+        mkdirSync(exDir, { recursive: true });
+        for (const ex of examples) {
+          const src = join(examplesSource, ex);
+          if (existsSync(src)) {
+            copyFileSync(src, join(exDir, ex));
+            exampleCount++;
+          }
+        }
+      }
+    } catch {
+      // Silently skip
     }
-    console.log(`  ax-crew: installed ${skillFiles.length} skills → ${claudeDir}`);
-  } catch {
-    // Silently skip
+  }
+  if (claudeCount > 0) {
+    console.log(`  ax-crew: installed ${claudeCount} skills + ${exampleCount} examples → .claude/skills/`);
   }
 
-  // Codex: single SKILL.md combining all skills in project dir
+  // Codex: single combined SKILL.md in one directory
   const codexDir = join(projectRoot, '.agents', 'skills', 'ax-crew');
   try {
     mkdirSync(codexDir, { recursive: true });
@@ -72,7 +104,7 @@ function installSkills() {
     }
 
     writeFileSync(join(codexDir, 'SKILL.md'), combined.trim());
-    console.log(`  ax-crew: installed combined SKILL.md → ${codexDir}`);
+    console.log(`  ax-crew: installed combined SKILL.md → .agents/skills/ax-crew/`);
   } catch {
     // Silently skip
   }

package/scripts/uninstall-skills.mjs

@@ -4,23 +4,29 @@
  * Preuninstall script: removes ax-crew skill files from the project directory.
  */
 
-import { existsSync, rmSync } from 'fs';
+import { existsSync, rmSync, readdirSync } from 'fs';
 import { join } from 'path';
 
 const projectRoot = process.env.INIT_CWD || process.cwd();
 
-const targets = [
-  join(projectRoot, '.claude', 'skills', 'ax-crew'),
-  join(projectRoot, '.agents', 'skills', 'ax-crew'),
-];
-
-for (const dir of targets) {
-  try {
-    if (existsSync(dir)) {
-      rmSync(dir, { recursive: true });
-      console.log(`  ax-crew: removed skills from ${dir}`);
+// Remove all ax-crew-* skill directories from .claude/skills/
+const claudeSkillsDir = join(projectRoot, '.claude', 'skills');
+if (existsSync(claudeSkillsDir)) {
+  for (const dir of readdirSync(claudeSkillsDir)) {
+    if (dir.startsWith('axcrew')) {
+      try {
+        rmSync(join(claudeSkillsDir, dir), { recursive: true });
+      } catch {}
     }
-  } catch {
-    // Silently skip
   }
+  console.log('  ax-crew: removed Claude Code skills');
+}
+
+// Remove Codex combined skill
+const codexDir = join(projectRoot, '.agents', 'skills', 'ax-crew');
+if (existsSync(codexDir)) {
+  try {
+    rmSync(codexDir, { recursive: true });
+    console.log('  ax-crew: removed Codex skills');
+  } catch {}
 }

package/src/skills/{ax-crew-ace.md → axcrew-ace.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-ace
-version: __VERSION__
+name: axcrew-ace
+version: 8.7.3
 description: "ACE (Agentic Context Engineering) for AxCrew: feedback loops, online learning, playbook persistence, and optimization."
 tags: [ace, agentic-context-engineering, feedback, learning, playbook, online-update, optimize]
 ---
@@ -150,6 +150,10 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/ace-customer-support.ts](examples/ace-customer-support.ts) for a complete runnable example.
+- See [examples/ace-flight-finder.ts](examples/ace-flight-finder.ts) for another ACE example.
+
 ## Do Not Generate
 
 - Do NOT call `initACE()` manually -- it is called automatically when `addAgent()` / `addAgentsToCrew()` detects an `ace` config on the agent.
@@ -160,6 +164,7 @@ main().catch(console.error);
 
 ## References
 
-- [ace-customer-support.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/ace-customer-support.ts)
-- [src/agents/ace.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/agents/ace.ts)
+- [ace-customer-support.ts](examples/ace-customer-support.ts)
+- [ace-flight-finder.ts](examples/ace-flight-finder.ts)
+- [src/agents/ace.ts](src/agents/ace.ts)
 - [AxACE upstream docs](https://axllm.dev/ace/)

package/src/skills/{ax-crew-agent-config.md → axcrew-agent-config.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-agent-config
-version: __VERSION__
+name: axcrew-agent-config
+version: 8.7.3
 description: "AgentConfig - agent configuration: provider, signature, model, temperature, definition, prompt, executionMode, axAgentOptions, providerArgs"
 ---
 
@@ -167,6 +167,9 @@ DSPy-style string signatures with optional field descriptions:
 
 Supported types: `string`, `number`, `boolean`, `string[]`, `number[]`, etc.
 
+## Supporting files
+- See [examples/providerArgs.ts](examples/providerArgs.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT omit `name`, `description`, `signature`, `provider`, or `ai.model` -- all are required.
@@ -177,5 +180,5 @@ Supported types: `string`, `number`, `boolean`, `string[]`, `number[]`, etc.
 
 ## References
 
-- [basic-researcher-writer.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/basic-researcher-writer.ts)
-- [providerArgs.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/providerArgs.ts)
+- [basic-researcher-writer.ts](examples/basic-researcher-writer.ts)
+- [providerArgs.ts](examples/providerArgs.ts)

package/src/skills/{ax-crew-code-execution.md → axcrew-code-execution.md}

@@ -1,7 +1,7 @@
 ---
-name: ax-crew-code-execution
+name: axcrew-code-execution
 description: AxCrew code execution with AxJSRuntime for sandboxed JavaScript execution. Covers AxJSRuntime setup, permissions, executionMode axagent, RLM mode, and runtime configuration for autonomous code generation and execution.
-version: "__VERSION__"
+version: "8.7.3"
 ---
 
 # AxCrew Code Execution
@@ -152,6 +152,9 @@ const config: AxCrewConfig = {
 };
 ```
 
+## Supporting files
+- See [examples/rlm-long-task.ts](examples/rlm-long-task.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT use `executionMode: "axgen"` with `runtime` -- code execution requires `"axagent"` mode
@@ -162,5 +165,5 @@ const config: AxCrewConfig = {
 
 ## References
 
-- [rlm-long-task.ts](../examples/rlm-long-task.ts) -- full RLM agent with context management
-- [rlm-shared-fields.ts](../examples/rlm-shared-fields.ts) -- shared runtime across sub-agents
+- [rlm-long-task.ts](examples/rlm-long-task.ts) -- full RLM agent with context management
+- [rlm-shared-fields.ts](examples/rlm-shared-fields.ts) -- shared runtime across sub-agents

package/src/skills/{ax-crew-execution-modes.md → axcrew-execution-modes.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-execution-modes
-version: "__VERSION__"
+name: axcrew-execution-modes
+version: "8.7.3"
 description: "ax-crew execution modes: execution mode, axgen, axagent, RLM, runtime, contextFields, AxJSRuntime, contextManagement, fields, shared, globallyShared, excluded, maxTurns, maxSubAgentCalls"
 argument-hint: [topic]
 allowed-tools: Read, Grep, Glob
@@ -270,6 +270,10 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/rlm-long-task.ts](examples/rlm-long-task.ts) for a complete runnable example.
+- See [examples/rlm-shared-fields.ts](examples/rlm-shared-fields.ts) for shared fields between agents.
+
 ## Do Not Generate
 
 - Do NOT use `axAgentOptions` without setting `executionMode: "axagent"` -- it is ignored in `axgen` mode.
@@ -281,7 +285,7 @@ main().catch(console.error);
 
 ## References
 
-- [rlm-long-task.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/rlm-long-task.ts)
-- [rlm-shared-fields.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/rlm-shared-fields.ts)
-- [Source: AxCrewAxAgentOptions type](https://github.com/amitdeshmukh/ax-crew/blob/main/src/types.ts)
-- [Source: StatefulAxAgent execution mode handling](https://github.com/amitdeshmukh/ax-crew/blob/main/src/agents/index.ts)
+- [rlm-long-task.ts](examples/rlm-long-task.ts)
+- [rlm-shared-fields.ts](examples/rlm-shared-fields.ts)
+- [Source: AxCrewAxAgentOptions type](src/types.ts)
+- [Source: StatefulAxAgent execution mode handling](src/agents/index.ts)

package/src/skills/{ax-crew-few-shot.md → axcrew-few-shot.md}

@@ -1,7 +1,7 @@
 ---
-name: ax-crew-few-shot
+name: axcrew-few-shot
 description: AxCrew few-shot examples via examples[] field in AgentConfig. Covers in-context learning, demonstration structure, input/output field matching, setExamplesCompat() for dynamic updates, and when to use examples vs definition/prompt.
-version: "__VERSION__"
+version: "8.7.3"
 ---
 
 # AxCrew Few-Shot Examples
@@ -151,6 +151,9 @@ const agent = crew.agents?.get("SupportAgent");
 
 Best practice: use `definition`/`prompt` for WHO the agent is, `examples[]` for HOW it should respond.
 
+## Supporting files
+- See [examples/solve-math-problem.ts](examples/solve-math-problem.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT embed examples as text in `definition` or `prompt` -- use the `examples[]` field for structured few-shot learning
@@ -161,5 +164,6 @@ Best practice: use `definition`/`prompt` for WHO the agent is, `examples[]` for
 
 ## References
 
-- [ace-customer-support.ts](../examples/ace-customer-support.ts) -- agent with structured examples and ACE feedback
-- [basic-researcher-writer.ts](../examples/basic-researcher-writer.ts) -- simple agent config
+- [solve-math-problem.ts](examples/solve-math-problem.ts) -- agent with few-shot examples
+- [ace-customer-support.ts](examples/ace-customer-support.ts) -- agent with structured examples and ACE feedback
+- [basic-researcher-writer.ts](examples/basic-researcher-writer.ts) -- simple agent config

package/src/skills/{ax-crew-functions.md → axcrew-functions.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-functions
-version: __VERSION__
+name: axcrew-functions
+version: 8.7.3
 description: "Functions and tools: FunctionRegistryType, AxFunction, toFunction, custom functions, AxCrewFunctions, class-based functions with state"
 ---
 
@@ -204,6 +204,9 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT define functions inline in AgentConfig; always use a `FunctionRegistryType` registry passed to the `AxCrew` constructor.
@@ -213,6 +216,6 @@ main().catch(console.error);
 
 ## References
 
-- [write-post-and-publish-to-wordpress.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/write-post-and-publish-to-wordpress.ts)
-- [src/functions/dateTime.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/functions/dateTime.ts)
-- [src/functions/index.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/functions/index.ts)
+- [write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts)
+- [src/functions/dateTime.ts](src/functions/dateTime.ts)
+- [src/functions/index.ts](src/functions/index.ts)

package/src/skills/{ax-crew-mcp.md → axcrew-mcp.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-mcp
-version: "__VERSION__"
+name: axcrew-mcp
+version: "8.7.3"
 description: "ax-crew MCP integration: MCP, Model Context Protocol, STDIO, HTTP SSE, Streamable HTTP, mcpServers, tools, tool filtering, multiple servers"
 argument-hint: [topic]
 allowed-tools: Read, Grep, Glob
@@ -205,6 +205,10 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/mcp-agent.ts](examples/mcp-agent.ts) for a complete runnable example.
+- See [examples/graphjin-database-agent.ts](examples/graphjin-database-agent.ts) for Streamable HTTP transport.
+
 ## Do Not Generate
 
 - Do NOT mix transport config keys -- use exactly one of `command`, `sseUrl`, or `mcpEndpoint` per server entry.
@@ -215,7 +219,7 @@ main().catch(console.error);
 
 ## References
 
-- [mcp-agent.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/mcp-agent.ts)
-- [graphjin-database-agent.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/graphjin-database-agent.ts)
-- [Source: agentConfig.ts (initializeMCPServers)](https://github.com/amitdeshmukh/ax-crew/blob/main/src/agents/agentConfig.ts)
-- [Types: MCPStdioTransportConfig, MCPHTTPSSETransportConfig, MCPStreamableHTTPTransportConfig](https://github.com/amitdeshmukh/ax-crew/blob/main/src/types.ts)
+- [mcp-agent.ts](examples/mcp-agent.ts)
+- [graphjin-database-agent.ts](examples/graphjin-database-agent.ts)
+- [Source: agentConfig.ts (initializeMCPServers)](src/agents/agentConfig.ts)
+- [Types: MCPStdioTransportConfig, MCPHTTPSSETransportConfig, MCPStreamableHTTPTransportConfig](src/types.ts)

package/src/skills/{ax-crew-metrics.md → axcrew-metrics.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-metrics
-version: "__VERSION__"
+name: axcrew-metrics
+version: "8.7.3"
 description: "ax-crew metrics and cost tracking: metrics, cost, tracking, getMetrics, getCrewMetrics, MetricsSnapshot, usage, tokens, estimatedCostUSD, resetCosts, resetCrewMetrics"
 argument-hint: [topic]
 allowed-tools: Read, Grep, Glob
@@ -154,6 +154,9 @@ if (m?.functions?.details) {
 }
 ```
 
+## Supporting files
+- See [examples/basic-researcher-writer.ts](examples/basic-researcher-writer.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT call `getMetrics()` on the crew object -- use `crew.getCrewMetrics()` for crew-level and `agent.getMetrics()` for per-agent.
@@ -164,7 +167,7 @@ if (m?.functions?.details) {
 
 ## References
 
-- [basic-researcher-writer.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/basic-researcher-writer.ts)
-- [rlm-long-task.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/rlm-long-task.ts)
-- [Source: MetricsSnapshot type](https://github.com/amitdeshmukh/ax-crew/blob/main/src/metrics/types.ts)
-- [Source: MetricsRegistry](https://github.com/amitdeshmukh/ax-crew/blob/main/src/metrics/registry.ts)
+- [basic-researcher-writer.ts](examples/basic-researcher-writer.ts)
+- [rlm-long-task.ts](examples/rlm-long-task.ts)
+- [Source: MetricsSnapshot type](src/metrics/types.ts)
+- [Source: MetricsRegistry](src/metrics/registry.ts)

package/src/skills/{ax-crew-patterns.md → axcrew-patterns.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-patterns
-version: __VERSION__
+name: axcrew-patterns
+version: 8.7.3
 description: "AxCrew multi-agent patterns: pipeline, delegation, fan-out, orchestrator, sequential workflows, and agent coordination."
 tags: [patterns, workflow, pipeline, multi-agent, orchestrator, delegation, sequential, fan-out]
 ---
@@ -271,6 +271,10 @@ class MyTool {
 }
 ```
 
+## Supporting files
+- See [examples/write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts) for a complete pipeline example.
+- See [examples/solve-math-problem.ts](examples/solve-math-problem.ts) for a delegation example.
+
 ## Do Not Generate
 
 - Do NOT add a parent agent before its sub-agents -- `addAgentsToCrew` resolves dependencies but `addAgent` does not.
@@ -281,6 +285,6 @@ class MyTool {
 
 ## References
 
-- [write-post-and-publish-to-wordpress.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/write-post-and-publish-to-wordpress.ts) (4-agent pipeline)
-- [solve-math-problem.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/solve-math-problem.ts) (delegation)
-- [search-tweets.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/search-tweets.ts) (streaming)
+- [write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts) (4-agent pipeline)
+- [solve-math-problem.ts](examples/solve-math-problem.ts) (delegation)
+- [search-tweets.ts](examples/search-tweets.ts) (streaming)

package/src/skills/{ax-crew-providers.md → axcrew-providers.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-providers
-version: __VERSION__
+name: axcrew-providers
+version: 8.7.3
 description: "AxCrew provider configuration: openai, anthropic, google-gemini, azure-openai, groq, ollama, mistral, cohere, grok/xAI, perplexity, and model setup."
 tags: [provider, openai, anthropic, google-gemini, azure, groq, ollama, mistral, cohere, model, grok, perplexity]
 ---
@@ -187,6 +187,11 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/providerArgs.ts](examples/providerArgs.ts) for Azure OpenAI configuration.
+- See [examples/search-tweets.ts](examples/search-tweets.ts) for Grok/xAI usage.
+- See [examples/perplexityDeepSearch.ts](examples/perplexityDeepSearch.ts) for Perplexity MCP integration.
+
 ## Do Not Generate
 
 - Do NOT hardcode API keys in config -- always use `providerKeyName` which reads from `process.env`.
@@ -197,8 +202,8 @@ main().catch(console.error);
 
 ## References
 
-- [providerArgs.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/providerArgs.ts) (Azure OpenAI)
-- [search-tweets.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/search-tweets.ts) (Grok/xAI)
-- [perplexityDeepSearch.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/perplexityDeepSearch.ts) (Perplexity MCP)
-- [write-post-and-publish-to-wordpress.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/write-post-and-publish-to-wordpress.ts) (mixed providers)
-- [src/agents/compose.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/agents/compose.ts)
+- [providerArgs.ts](examples/providerArgs.ts) (Azure OpenAI)
+- [search-tweets.ts](examples/search-tweets.ts) (Grok/xAI)
+- [perplexityDeepSearch.ts](examples/perplexityDeepSearch.ts) (Perplexity MCP)
+- [write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts) (mixed providers)
+- [src/agents/compose.ts](src/agents/compose.ts)

package/src/skills/{ax-crew-signatures.md → axcrew-signatures.md}

@@ -1,7 +1,7 @@
 ---
-name: ax-crew-signatures
+name: axcrew-signatures
 description: AxCrew DSPy-style signature format for defining agent inputs/outputs. Covers signature syntax, types (string, number, boolean, class, string[], json, image, audio, date), optional fields (?), field descriptions, and AxSignature builder alternative.
-version: "__VERSION__"
+version: "8.7.3"
 ---
 
 # AxCrew Signatures
@@ -164,6 +164,6 @@ const config: AxCrewConfig = {
 
 ## References
 
-- [rlm-long-task.ts](../examples/rlm-long-task.ts) -- array output in signature
-- [rlm-shared-fields.ts](../examples/rlm-shared-fields.ts) -- field descriptions in quotes
-- [ace-customer-support.ts](../examples/ace-customer-support.ts) -- multi-output signature
+- [rlm-long-task.ts](examples/rlm-long-task.ts) -- array output in signature
+- [rlm-shared-fields.ts](examples/rlm-shared-fields.ts) -- field descriptions in quotes
+- [ace-customer-support.ts](examples/ace-customer-support.ts) -- multi-output signature

package/src/skills/{ax-crew-state.md → axcrew-state.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-state
-version: __VERSION__
+name: axcrew-state
+version: 8.7.3
 description: "State management: shared state, StateInstance, set, get, getAll, reset, accessing state from class-based functions"
 ---
 
@@ -154,6 +154,9 @@ const agent = crew.agents?.get("myAgent");
 // agent.state is the same StateInstance as crew.state
 ```
 
+## Supporting files
+- See [examples/write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT assume state values exist without checking; always use optional chaining (e.g. `this.state.env?.KEY`).
@@ -163,6 +166,6 @@ const agent = crew.agents?.get("myAgent");
 
 ## References
 
-- [write-post-and-publish-to-wordpress.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/write-post-and-publish-to-wordpress.ts)
-- [src/state/index.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/state/index.ts)
-- [src/types.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/src/types.ts)
+- [write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts)
+- [src/state/index.ts](src/state/index.ts)
+- [src/types.ts](src/types.ts)

package/src/skills/{ax-crew-streaming.md → axcrew-streaming.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-streaming
-version: "__VERSION__"
+name: axcrew-streaming
+version: "8.7.3"
 description: "ax-crew streaming patterns: streaming, streamingForward, stream, delta, real-time, chunks, async generator consumption"
 argument-hint: [topic]
 allowed-tools: Read, Grep, Glob
@@ -129,6 +129,9 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/streaming.ts](examples/streaming.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT `await` the return of `streamingForward()` -- it returns the async generator directly, not a promise.
@@ -139,5 +142,5 @@ main().catch(console.error);
 
 ## References
 
-- [streaming.ts example](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/streaming.ts)
-- [Source: StatefulAxAgent.streamingForward](https://github.com/amitdeshmukh/ax-crew/blob/main/src/agents/index.ts)
+- [streaming.ts](examples/streaming.ts)
+- [Source: StatefulAxAgent.streamingForward](src/agents/index.ts)

package/src/skills/{ax-crew-sub-agents.md → axcrew-sub-agents.md}

@@ -1,7 +1,7 @@
 ---
-name: ax-crew-sub-agents
+name: axcrew-sub-agents
 description: AxCrew sub-agent composition via agents[] field. Covers agent delegation, dependency resolution, lazy agents (addLazyAgent), parent-child tool integration, and multi-agent orchestration patterns.
-version: "__VERSION__"
+version: "8.7.3"
 ---
 
 # AxCrew Sub-Agents
@@ -189,6 +189,10 @@ crew.addLazyAgent("RarelyUsedAgent");
 
 The lazy agent exposes the same `getFunction()` interface. When the parent agent delegates to it, the real agent is created on-demand.
 
+## Supporting files
+- See [examples/basic-researcher-writer.ts](examples/basic-researcher-writer.ts) for simple delegation.
+- See [examples/rlm-shared-fields.ts](examples/rlm-shared-fields.ts) for multi-agent with shared fields.
+
 ## Do Not Generate
 
 - Do NOT list an agent in `agents[]` that is not defined in the crew config
@@ -199,5 +203,5 @@ The lazy agent exposes the same `getFunction()` interface. When the parent agent
 
 ## References
 
-- [basic-researcher-writer.ts](../examples/basic-researcher-writer.ts) -- simple delegation
-- [rlm-shared-fields.ts](../examples/rlm-shared-fields.ts) -- multi-agent with shared fields
+- [basic-researcher-writer.ts](examples/basic-researcher-writer.ts) -- simple delegation
+- [rlm-shared-fields.ts](examples/rlm-shared-fields.ts) -- multi-agent with shared fields

package/src/skills/{ax-crew-telemetry.md → axcrew-telemetry.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew-telemetry
-version: __VERSION__
+name: axcrew-telemetry
+version: 8.7.3
 description: "AxCrew telemetry: OpenTelemetry tracing, metrics, observability with tracer and meter injection."
 tags: [telemetry, opentelemetry, tracing, metrics, observability, tracer, meter]
 ---
@@ -148,6 +148,9 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Supporting files
+- See [examples/telemetry-demo.ts](examples/telemetry-demo.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT import OpenTelemetry types from `ax-crew` -- import them from `@opentelemetry/api` and the SDK packages.
@@ -157,5 +160,5 @@ main().catch(console.error);
 
 ## References
 
-- [telemetry-demo.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/telemetry-demo.ts)
+- [telemetry-demo.ts](examples/telemetry-demo.ts)
 - [OpenTelemetry JS](https://opentelemetry.io/docs/languages/js/)

package/src/skills/{ax-crew.md → axcrew.md}

@@ -1,6 +1,6 @@
 ---
-name: ax-crew
-version: __VERSION__
+name: axcrew
+version: 8.7.3
 description: "AxCrew - multi-agent orchestration: crew, agents, addAgent, addAllAgents, addAgentsToCrew, forward, streaming, sub-agents"
 ---
 
@@ -109,6 +109,9 @@ new AxCrew(crewConfig: AxCrewConfig, functionsRegistry?: FunctionRegistryType, o
 - `ax-crew-functions` -- Function registry, custom tools, class-based functions
 - `ax-crew-state` -- Shared state API, accessing state from functions
 
+## Supporting files
+- See [examples/basic-researcher-writer.ts](examples/basic-researcher-writer.ts) for a complete runnable example.
+
 ## Do Not Generate
 
 - Do NOT instantiate `AxAgent` or `AxGen` directly; use `AxCrew` which wraps them as `StatefulAxAgent`.
@@ -119,6 +122,6 @@ new AxCrew(crewConfig: AxCrewConfig, functionsRegistry?: FunctionRegistryType, o
 
 ## References
 
-- [basic-researcher-writer.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/basic-researcher-writer.ts)
-- [write-post-and-publish-to-wordpress.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/write-post-and-publish-to-wordpress.ts)
-- [providerArgs.ts](https://github.com/amitdeshmukh/ax-crew/blob/main/examples/providerArgs.ts)
+- [basic-researcher-writer.ts](examples/basic-researcher-writer.ts)
+- [write-post-and-publish-to-wordpress.ts](examples/write-post-and-publish-to-wordpress.ts)
+- [providerArgs.ts](examples/providerArgs.ts)