@amitdeshmukh/ax-crew 8.7.1 → 9.0.0

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"
 ---
 
@@ -192,7 +192,7 @@ async function main() {
   const crew = new AxCrew(config, customFunctions);
 
   // Set state for class-based functions
-  crew.state.set("env", { API_BASE_URL: "https://api.example.com" });
+  crew.crewState.set("env", { API_BASE_URL: "https://api.example.com" });
 
   await crew.addAllAgents();
   const assistant = crew.agents?.get("assistant");
@@ -204,15 +204,18 @@ 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.
-- Do NOT forget that class-based function constructors receive `state: Record<string, any>`, not `StateInstance`. Access values directly (e.g. `this.state.env`), since the state object is a plain record populated via `crew.state.set()`.
+- Do NOT forget that class-based function constructors receive `state: Record<string, any>`, not `StateInstance`. Access values directly (e.g. `this.state.env`), since the state object is a plain record populated via `crew.crewState.set()`.
 - Do NOT use a registry key that differs from the function name used in `AgentConfig.functions[]` -- they must match.
 - Do NOT import `AxCrewFunctions` from `@ax-llm/ax`; import from `@amitdeshmukh/ax-crew`.
 
 ## 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: "9.0.0"
 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,50 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Deferred Tool Loading
+
+When an agent has many MCP tools (20+), use the `deferredTools` config to reduce token usage. Only core tools + a `search_tools` meta-function are sent to the LLM. The LLM discovers additional tools on demand. Discovered tools persist across `forward()` calls. Tool results that mention deferred tool names (e.g., error responses suggesting `fix_query_error`) auto-activate those tools.
+
+```typescript
+{
+  name: "BigMCPAgent",
+  description: "Agent with many MCP tools",
+  signature: 'query:string -> answer:string',
+  provider: "anthropic",
+  providerKeyName: "ANTHROPIC_API_KEY",
+  ai: { model: "claude-sonnet-4-6", temperature: 0 },
+  mcpServers: {
+    "large-server": {
+      command: "npx",
+      args: ["-y", "some-large-mcp-server"],
+    },
+  },
+  deferredTools: {
+    enabled: true,       // default: auto (true when tool count > threshold)
+    threshold: 20,       // tool count to activate deferred mode
+    maxSearchResults: 10, // max tools returned per search
+    coreTools: ["execute_graphql", "list_tables"],  // always keep active
+  },
+}
+```
+
+### What is "core" vs "deferred"
+
+- **Core** (always visible): custom functions, sub-agent functions, `resource_*` functions, explicitly listed `coreTools`
+- **Deferred** (discoverable via search): MCP tool functions (except `resource_*`)
+
+### Resource Caching
+
+MCP `resource_*` functions (reference docs like query syntax guides) are automatically cached in-memory. Repeated calls return the cached result without re-fetching from the MCP server.
+
+## Prompt Caching
+
+Prompt caching is enabled by default for all agents. System prompts and tool definitions are cached across multi-step interactions via Anthropic's implicit caching or Gemini's context caching. This reduces token costs by up to 6x for agents with many tools — the system prompt (~13K tokens of tool schemas) is processed once and reused on subsequent steps.
+
+## 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 +259,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: 9.0.0
 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]
 ---
@@ -251,8 +251,8 @@ Target audience: intermediate developers familiar with TypeScript.`,
 All agents in a crew share a mutable `state` object for out-of-band data passing:
 
 ```ts
-crew.state.set("env", { WORDPRESS_URL: "http://...", WORDPRESS_USERNAME: "..." });
-crew.state.set("context", { userId: "abc-123" });
+crew.crewState.set("env", { WORDPRESS_URL: "http://...", WORDPRESS_USERNAME: "..." });
+crew.crewState.set("context", { userId: "abc-123" });
 
 // Inside a custom function, state is accessible via the constructor:
 class MyTool {
@@ -271,16 +271,64 @@ class MyTool {
 }
 ```
 
+## Cost Optimization Pattern (Single-Delegation Manager)
+
+When a manager orchestrates sub-agents, use a **single-delegation** pattern: send the full question to the sub-agent in one call. Do NOT break questions into sub-queries — the sub-agent handles multi-step work internally.
+
+This pattern reduced costs from $128 to $1 on the same query in testing.
+
+```ts
+{
+  name: "ManagerAgent",
+  description: "Orchestrates database queries and analysis tasks",
+  definition: `You are an orchestrator that routes questions to specialized agents.
+Delegate each question to the most relevant agent in a SINGLE call — do not break questions into sub-queries.
+The sub-agent will handle all the steps internally. Your job is to route and synthesize, not to decompose.
+If multiple agents are needed, call them and combine their answers.`,
+  signature: 'question:string -> answer:string',
+  provider: "anthropic" as Provider,
+  providerKeyName: "ANTHROPIC_API_KEY",
+  ai: { model: "claude-sonnet-4-6", maxTokens: 2000, temperature: 0 },
+  agents: ["DatabaseAgent", "AnalyticsAgent"],
+}
+```
+
+## Workflow Reuse Pattern (MCP Agents)
+
+For agents connected to MCP servers, use a strategy-driven definition that checks for saved workflows before building new ones. This ensures repeat questions reuse cached workflows ($0.17) instead of rebuilding from scratch ($0.55).
+
+```ts
+{
+  name: "DatabaseAgent",
+  definition: `You answer questions by querying databases via an MCP server.
+
+STRATEGY:
+1. Check first — call list_workflows and list_saved_queries. If a match exists, execute it directly.
+2. Learn — read resource docs, list tables, describe schema.
+3. Build — author a JS workflow with server-side computation, validate with a test query.
+4. Save and run — save the workflow for reuse, then execute it.
+5. If a query fails, call fix_query_error to diagnose. Do not retry the same query.
+6. Synthesize the answer from results.`,
+  // ...
+}
+```
+
+## 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.
+- See [examples/graphjin-database-agent.ts](examples/graphjin-database-agent.ts) for single-delegation + workflow reuse pattern.
+
 ## Do Not Generate
 
 - Do NOT add a parent agent before its sub-agents -- `addAgentsToCrew` resolves dependencies but `addAgent` does not.
 - Do NOT use `agents: ["SelfName"]` -- an agent cannot be its own sub-agent (circular dependency error).
-- Do NOT assume agents share conversation context -- they share `state` but each `forward()` call is independent. Pass data explicitly via signatures.
+- Do NOT assume agents share conversation context -- they share `crewState` but each `forward()` call is independent. Pass data explicitly via signatures.
 - Do NOT use `definition` shorter than 100 characters -- Ax requires minimum length for program definitions.
 - Do NOT confuse `description` (used as the tool description when this agent is a sub-agent) with `definition` (the system prompt).
+- Do NOT have the manager decompose questions into sub-queries -- send the full question to the sub-agent in one call.
 
 ## 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,12 +1,12 @@
 ---
-name: ax-crew-state
-version: __VERSION__
+name: axcrew-state
+version: 9.0.0
 description: "State management: shared state, StateInstance, set, get, getAll, reset, accessing state from class-based functions"
 ---
 
 # State
 
-Every `AxCrew` instance has a shared `StateInstance` at `crew.state`. All agents and class-based functions in the crew can access the same state.
+Every `AxCrew` instance has a shared `StateInstance` at `crew.crewState`. All agents and class-based functions in the crew can access the same state.
 
 ## StateInstance API
 
@@ -21,9 +21,9 @@ interface StateInstance {
 
 ## Core Behavior
 
-- `crew.state` is created automatically when `new AxCrew(config)` is called.
+- `crew.crewState` is created automatically when `new AxCrew(config)` is called.
 - State is keyed by `crewId` (auto-generated UUID). Each crew instance has its own isolated state.
-- State persists for the lifetime of the crew. Calling `crew.destroy()` calls `state.reset()`.
+- State persists for the lifetime of the crew. Calling `crew.destroy()` calls `crewState.reset()`.
 - Values can be any type: strings, objects, arrays, etc.
 
 ## Canonical Pattern
@@ -53,7 +53,7 @@ class SendEmail {
         required: ['to', 'subject', 'body']
       },
       func: async ({ to, subject, body }: { to: string; subject: string; body: string }) => {
-        // Access env credentials set via crew.state.set("env", {...})
+        // Access env credentials set via crew.crewState.set("env", {...})
         const env = this.state.env || {};
         const smtpHost = env.SMTP_HOST;
         const smtpUser = env.SMTP_USER;
@@ -84,15 +84,15 @@ async function main() {
   const crew = new AxCrew(config, functions);
 
   // Set environment variables in shared state BEFORE adding agents
-  crew.state.set("env", {
+  crew.crewState.set("env", {
     SMTP_HOST: "smtp.example.com",
     SMTP_USER: "user@example.com",
     SMTP_PASS: "secret",
   });
 
   // You can also set arbitrary data
-  crew.state.set("company", "Acme Corp");
-  crew.state.set("maxRetries", 3);
+  crew.crewState.set("company", "Acme Corp");
+  crew.crewState.set("maxRetries", 3);
 
   await crew.addAllAgents();
   const notifier = crew.agents?.get("notifier");
@@ -101,11 +101,11 @@ async function main() {
   console.log(result?.result);
 
   // Read state back
-  console.log("All state:", crew.state.getAll());
-  console.log("Company:", crew.state.get("company"));
+  console.log("All state:", crew.crewState.getAll());
+  console.log("Company:", crew.crewState.get("company"));
 
   // Reset state (clear all)
-  crew.state.reset();
+  crew.crewState.reset();
 
   crew.destroy();
 }
@@ -118,7 +118,7 @@ main().catch(console.error);
 The common pattern for passing credentials to class-based functions:
 
 ```ts
-crew.state.set("env", {
+crew.crewState.set("env", {
   WORDPRESS_URL: "http://my-wordpress-site.com",
   WORDPRESS_USERNAME: "my-username",
   WORDPRESS_PASSWORD: "my-password",
@@ -147,22 +147,25 @@ class MyFunction {
 
 ## Accessing State from Agents
 
-Each `StatefulAxAgent` has a `state` property that references the crew's shared state:
+Each `StatefulAxAgent` has a `crewState` property that references the crew's shared state:
 
 ```ts
 const agent = crew.agents?.get("myAgent");
-// agent.state is the same StateInstance as crew.state
+// agent.crewState is the same StateInstance as crew.crewState
 ```
 
+## 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`).
-- Do NOT call `crew.state.set("env", ...)` after `addAllAgents()` if class-based functions read state during construction -- set state first.
-- Do NOT confuse `crew.state` (StateInstance with `set`/`get`/`getAll`/`reset`) with plain objects. The state object passed to class-based function constructors is a plain record, not the `StateInstance` interface.
+- Do NOT call `crew.crewState.set("env", ...)` after `addAllAgents()` if class-based functions read state during construction -- set state first.
+- Do NOT confuse `crew.crewState` (StateInstance with `set`/`get`/`getAll`/`reset`) with plain objects. The state object passed to class-based function constructors is a plain record, not the `StateInstance` interface.
 - Do NOT store sensitive credentials in state if the state object might be logged or serialized. The `getAll()` method returns all stored values.
 
 ## 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/)