@operor/skills 0.1.0

package/skill-catalog.json

@@ -0,0 +1,465 @@
+{
+  "version": 1,
+  "updatedAt": "2026-02-18T00:00:00.000Z",
+  "skills": [
+    {
+      "name": "shopify",
+      "displayName": "Shopify",
+      "description": "Manage Shopify store products, customers, and orders via GraphQL Admin API",
+      "category": "commerce",
+      "tags": ["ecommerce", "shopify", "orders", "products", "inventory", "customers"],
+      "transport": "stdio",
+      "package": "shopify-mcp",
+      "command": "npx",
+      "args": ["-y", "shopify-mcp"],
+      "envVars": {
+        "SHOPIFY_ACCESS_TOKEN": {
+          "description": "Custom app access token from Shopify Admin > Settings > Apps",
+          "required": true,
+          "placeholder": "shpat_..."
+        },
+        "MYSHOPIFY_DOMAIN": {
+          "description": "Your store domain, e.g. my-store.myshopify.com",
+          "required": true,
+          "placeholder": "my-store.myshopify.com"
+        }
+      },
+      "tools": [
+        { "name": "get-products", "description": "List or search products in the store" },
+        { "name": "get-product-by-id", "description": "Get a specific product by ID" },
+        { "name": "createProduct", "description": "Create a new product" },
+        { "name": "get-customers", "description": "List or search customers" },
+        { "name": "update-customer", "description": "Update customer details" },
+        { "name": "get-customer-orders", "description": "Get orders for a specific customer" },
+        { "name": "get-orders", "description": "List or search orders" },
+        { "name": "get-order-by-id", "description": "Get details of a specific order" },
+        { "name": "update-order", "description": "Update an existing order" }
+      ],
+      "maturity": "community",
+      "vendor": "GeLi2001",
+      "docsUrl": "https://github.com/GeLi2001/shopify-mcp"
+    },
+    {
+      "name": "stripe",
+      "displayName": "Stripe",
+      "description": "Payment processing, subscriptions, invoicing, and financial operations via Stripe API",
+      "category": "payments",
+      "tags": ["payments", "stripe", "billing", "subscriptions", "invoices", "refunds"],
+      "transport": "stdio",
+      "package": "@stripe/mcp",
+      "command": "npx",
+      "args": ["-y", "@stripe/mcp", "--tools=all", "--api-key=${STRIPE_SECRET_KEY}"],
+      "envVars": {
+        "STRIPE_SECRET_KEY": {
+          "description": "Stripe secret API key (use restricted key for production)",
+          "required": true,
+          "placeholder": "sk_live_..."
+        }
+      },
+      "tools": [
+        { "name": "create_payment_intent", "description": "Create a payment intent" },
+        { "name": "list_customers", "description": "List Stripe customers" },
+        { "name": "create_refund", "description": "Refund a charge or payment intent" },
+        { "name": "list_subscriptions", "description": "List active subscriptions" }
+      ],
+      "maturity": "official",
+      "vendor": "Stripe",
+      "docsUrl": "https://github.com/stripe/agent-toolkit"
+    },
+    {
+      "name": "hubspot",
+      "displayName": "HubSpot CRM",
+      "description": "Manage contacts, companies, deals, pipelines, and associations in HubSpot CRM",
+      "category": "crm",
+      "tags": ["crm", "hubspot", "contacts", "deals", "sales", "pipeline"],
+      "transport": "stdio",
+      "package": "@cloud9-labs/mcp-hubspot",
+      "command": "npx",
+      "args": ["-y", "@cloud9-labs/mcp-hubspot"],
+      "envVars": {
+        "HUBSPOT_ACCESS_TOKEN": {
+          "description": "HubSpot Private App access token with CRM scopes",
+          "required": true,
+          "placeholder": "pat-..."
+        }
+      },
+      "tools": [
+        { "name": "hubspot_create_contact", "description": "Create a new contact" },
+        { "name": "hubspot_get_contact", "description": "Get contact details" },
+        { "name": "hubspot_update_contact", "description": "Update a contact" },
+        { "name": "hubspot_search_contacts", "description": "Search contacts by criteria" },
+        { "name": "hubspot_list_contacts", "description": "List all contacts" },
+        { "name": "hubspot_create_company", "description": "Create a new company" },
+        { "name": "hubspot_get_company", "description": "Get company details" },
+        { "name": "hubspot_search_companies", "description": "Search companies" },
+        { "name": "hubspot_create_deal", "description": "Create a new deal" },
+        { "name": "hubspot_get_deal", "description": "Get deal details" },
+        { "name": "hubspot_update_deal", "description": "Update a deal" },
+        { "name": "hubspot_list_deals", "description": "List all deals" },
+        { "name": "hubspot_get_pipelines", "description": "Get sales pipelines" },
+        { "name": "hubspot_create_association", "description": "Associate records together" }
+      ],
+      "maturity": "community",
+      "vendor": "Cloud9 Labs",
+      "docsUrl": "https://github.com/cloud9-labs/mcp-hubspot"
+    },
+    {
+      "name": "salesforce",
+      "displayName": "Salesforce",
+      "description": "Full Salesforce CRM integration with SOQL queries, CRUD operations, and backup/recovery",
+      "category": "crm",
+      "tags": ["crm", "salesforce", "leads", "opportunities", "sales"],
+      "transport": "stdio",
+      "package": "@aiondadotcom/mcp-salesforce",
+      "command": "npx",
+      "args": ["-y", "@aiondadotcom/mcp-salesforce"],
+      "envVars": {},
+      "tools": [
+        { "name": "salesforce_auth", "description": "Authenticate with Salesforce" },
+        { "name": "salesforce_setup", "description": "Interactive credential setup" },
+        { "name": "salesforce_query", "description": "Run SOQL queries" },
+        { "name": "salesforce_create", "description": "Create records" },
+        { "name": "salesforce_update", "description": "Update records" },
+        { "name": "salesforce_delete", "description": "Delete records" },
+        { "name": "salesforce_describe", "description": "Describe object schema" },
+        { "name": "salesforce_backup", "description": "Backup data" },
+        { "name": "salesforce_time_machine", "description": "Restore from backup" }
+      ],
+      "maturity": "community",
+      "vendor": "AiondaDotCom",
+      "docsUrl": "https://github.com/AiondaDotCom/mcp-salesforce"
+    },
+    {
+      "name": "zendesk",
+      "displayName": "Zendesk",
+      "description": "Search Help Center articles, retrieve article content, and create support tickets",
+      "category": "support",
+      "tags": ["support", "zendesk", "helpdesk", "tickets", "knowledge-base"],
+      "transport": "stdio",
+      "command": "node",
+      "args": ["dist/index.js"],
+      "envVars": {
+        "ZENDESK_SUBDOMAIN": {
+          "description": "Your Zendesk subdomain (e.g. 'mycompany' from mycompany.zendesk.com)",
+          "required": true,
+          "placeholder": "mycompany"
+        },
+        "ZENDESK_USERNAME": {
+          "description": "Admin email address for Zendesk",
+          "required": true,
+          "placeholder": "admin@example.com"
+        },
+        "ZENDESK_API_TOKEN": {
+          "description": "API token from Zendesk Admin > Channels > API",
+          "required": true,
+          "placeholder": "..."
+        }
+      },
+      "tools": [
+        { "name": "search_articles", "description": "Search Help Center articles" },
+        { "name": "get_article_content", "description": "Get full article content" },
+        { "name": "create_ticket", "description": "Create a support ticket" }
+      ],
+      "maturity": "community",
+      "vendor": "hatappo",
+      "docsUrl": "https://github.com/hatappo/mcp-server-zendesk"
+    },
+    {
+      "name": "intercom",
+      "displayName": "Intercom",
+      "description": "Search and filter Intercom conversations by date, status, and source type",
+      "category": "support",
+      "tags": ["support", "intercom", "conversations", "messaging", "customer-support"],
+      "transport": "stdio",
+      "command": "node",
+      "args": ["dist/index.js"],
+      "envVars": {
+        "INTERCOM_API_KEY": {
+          "description": "Intercom API key from Developer Hub",
+          "required": true,
+          "placeholder": "..."
+        }
+      },
+      "tools": [
+        { "name": "search-conversations", "description": "Search and filter conversations" }
+      ],
+      "maturity": "community",
+      "vendor": "fabian1710",
+      "docsUrl": "https://github.com/fabian1710/mcp-intercom"
+    },
+    {
+      "name": "mailchimp",
+      "displayName": "Mailchimp",
+      "description": "Full Mailchimp Marketing API: campaigns, audiences, templates, segments, automations, and reports",
+      "category": "marketing",
+      "tags": ["marketing", "email", "mailchimp", "campaigns", "newsletters", "audiences"],
+      "transport": "stdio",
+      "command": "node",
+      "args": ["dist/index.js"],
+      "envVars": {
+        "MAILCHIMP_API_KEY": {
+          "description": "Mailchimp API key in format xxx-usXX (datacenter auto-extracted)",
+          "required": true,
+          "placeholder": "abc123-us21"
+        }
+      },
+      "tools": [
+        { "name": "get_lists", "description": "Get all audiences/lists" },
+        { "name": "get_members", "description": "Get audience members" },
+        { "name": "add_member", "description": "Add a subscriber" },
+        { "name": "search_members", "description": "Search subscribers" },
+        { "name": "get_campaigns", "description": "Get campaigns" },
+        { "name": "create_campaign", "description": "Create a campaign" },
+        { "name": "send_campaign", "description": "Send a campaign" },
+        { "name": "get_templates", "description": "Get email templates" },
+        { "name": "get_campaign_report", "description": "Get campaign analytics" },
+        { "name": "get_segments", "description": "Get audience segments" },
+        { "name": "get_automations", "description": "Get automations" }
+      ],
+      "maturity": "community",
+      "vendor": "Snouzy",
+      "docsUrl": "https://github.com/Snouzy/m6b9-mcp-mailchimp"
+    },
+    {
+      "name": "sendgrid",
+      "displayName": "SendGrid",
+      "description": "Transactional and marketing email: send emails, manage contacts/lists, templates, and domain authentication",
+      "category": "marketing",
+      "tags": ["marketing", "email", "sendgrid", "transactional", "campaigns"],
+      "transport": "stdio",
+      "package": "primrose-mcp",
+      "command": "npx",
+      "args": ["-y", "primrose-mcp", "sendgrid"],
+      "envVars": {
+        "SENDGRID_API_KEY": {
+          "description": "SendGrid API key from Settings > API Keys",
+          "required": true,
+          "placeholder": "SG...."
+        }
+      },
+      "tools": [
+        { "name": "send_email", "description": "Send a transactional email" },
+        { "name": "send_template_email", "description": "Send email using a template" },
+        { "name": "send_bulk_email", "description": "Send bulk emails" },
+        { "name": "list_contacts", "description": "List marketing contacts" },
+        { "name": "create_contact", "description": "Create a contact" },
+        { "name": "search_contacts", "description": "Search contacts" },
+        { "name": "list_templates", "description": "List email templates" },
+        { "name": "get_global_stats", "description": "Get email delivery stats" }
+      ],
+      "maturity": "community",
+      "vendor": "Primrose",
+      "docsUrl": "https://github.com/primrose-mcp/primrose-mcp-sendgrid"
+    },
+    {
+      "name": "slack",
+      "displayName": "Slack",
+      "description": "Read/search Slack messages, list channels/users, manage user groups, and post messages",
+      "category": "communication",
+      "tags": ["communication", "slack", "messaging", "chat", "team"],
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@anthropic/mcp-slack"],
+      "envVars": {
+        "SLACK_BOT_TOKEN": {
+          "description": "Slack Bot token (xoxb-...) with appropriate scopes",
+          "required": true,
+          "placeholder": "xoxb-..."
+        }
+      },
+      "tools": [
+        { "name": "conversations_history", "description": "Get channel message history" },
+        { "name": "conversations_replies", "description": "Get thread replies" },
+        { "name": "conversations_search_messages", "description": "Search messages" },
+        { "name": "channels_list", "description": "List channels" },
+        { "name": "users_search", "description": "Search users" },
+        { "name": "conversations_add_message", "description": "Post a message" }
+      ],
+      "maturity": "community",
+      "vendor": "Anthropic",
+      "docsUrl": "https://github.com/modelcontextprotocol/servers/tree/main/src/slack"
+    },
+    {
+      "name": "linear",
+      "displayName": "Linear",
+      "description": "Manage Linear issues, projects, and teams — create, update, search, and track work items",
+      "category": "productivity",
+      "tags": ["productivity", "linear", "issues", "project-management", "tracking"],
+      "transport": "stdio",
+      "package": "@tacticlaunch/mcp-linear",
+      "command": "npx",
+      "args": ["-y", "@tacticlaunch/mcp-linear"],
+      "envVars": {
+        "LINEAR_API_TOKEN": {
+          "description": "Linear personal API key from Settings > API",
+          "required": true,
+          "placeholder": "lin_api_..."
+        }
+      },
+      "tools": [
+        { "name": "linear_get_issues", "description": "List issues" },
+        { "name": "linear_create_issue", "description": "Create an issue" },
+        { "name": "linear_update_issue", "description": "Update an issue" },
+        { "name": "linear_search_issues", "description": "Search issues" },
+        { "name": "linear_get_projects", "description": "List projects" },
+        { "name": "linear_create_project", "description": "Create a project" },
+        { "name": "linear_get_teams", "description": "List teams" },
+        { "name": "linear_add_comment", "description": "Add a comment to an issue" }
+      ],
+      "maturity": "community",
+      "vendor": "Tactic Launch",
+      "docsUrl": "https://github.com/tacticlaunch/mcp-linear"
+    },
+    {
+      "name": "notion",
+      "displayName": "Notion",
+      "description": "Access and manage Notion pages, databases, and comments for documentation and knowledge management",
+      "category": "productivity",
+      "tags": ["productivity", "notion", "documentation", "wiki", "databases"],
+      "transport": "stdio",
+      "package": "mcp-notion-server",
+      "command": "npx",
+      "args": ["-y", "mcp-notion-server"],
+      "envVars": {
+        "NOTION_API_KEY": {
+          "description": "Notion integration token from notion.so/my-integrations",
+          "required": true,
+          "placeholder": "ntn_..."
+        }
+      },
+      "tools": [
+        { "name": "notion_search", "description": "Search pages and databases" },
+        { "name": "notion_get_page", "description": "Get page content" },
+        { "name": "notion_create_page", "description": "Create a new page" },
+        { "name": "notion_update_page", "description": "Update a page" },
+        { "name": "notion_get_database", "description": "Get database schema" },
+        { "name": "notion_query_database", "description": "Query a database" },
+        { "name": "notion_create_database", "description": "Create a database" },
+        { "name": "notion_get_comments", "description": "Get page comments" },
+        { "name": "notion_add_comment", "description": "Add a comment" }
+      ],
+      "maturity": "community",
+      "vendor": "suekou",
+      "docsUrl": "https://github.com/suekou/mcp-notion-server"
+    },
+    {
+      "name": "brave-search",
+      "displayName": "Brave Search",
+      "description": "Web, local, video, image, and news search with AI-powered summaries via Brave Search API",
+      "category": "search",
+      "tags": ["search", "web", "brave", "internet", "news"],
+      "transport": "stdio",
+      "package": "@brave/brave-search-mcp-server",
+      "command": "npx",
+      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "envVars": {
+        "BRAVE_API_KEY": {
+          "description": "Brave Search API key from brave.com/search/api",
+          "required": true,
+          "placeholder": "BSA..."
+        }
+      },
+      "tools": [
+        { "name": "brave_web_search", "description": "Search the web" },
+        { "name": "brave_local_search", "description": "Search for local businesses and places" },
+        { "name": "brave_video_search", "description": "Search for videos" },
+        { "name": "brave_image_search", "description": "Search for images" },
+        { "name": "brave_news_search", "description": "Search news articles" },
+        { "name": "brave_summarizer", "description": "Get AI-powered search summaries" }
+      ],
+      "maturity": "official",
+      "vendor": "Brave",
+      "docsUrl": "https://github.com/brave/brave-search-mcp-server"
+    },
+    {
+      "name": "google-sheets",
+      "displayName": "Google Sheets",
+      "description": "Create and modify Google Sheets spreadsheets with Google Drive integration",
+      "category": "productivity",
+      "tags": ["productivity", "google", "spreadsheets", "sheets", "data"],
+      "transport": "stdio",
+      "package": "mcp-google-sheets",
+      "command": "npx",
+      "args": ["-y", "mcp-google-sheets"],
+      "envVars": {
+        "GOOGLE_SHEETS_CREDENTIALS": {
+          "description": "Path to Google service account credentials JSON file",
+          "required": true,
+          "placeholder": "/path/to/credentials.json"
+        }
+      },
+      "tools": [
+        { "name": "create_spreadsheet", "description": "Create a new spreadsheet" },
+        { "name": "get_spreadsheet", "description": "Get spreadsheet data" },
+        { "name": "update_cells", "description": "Update cell values" },
+        { "name": "append_rows", "description": "Append rows to a sheet" },
+        { "name": "create_sheet", "description": "Create a new sheet tab" },
+        { "name": "list_sheets", "description": "List sheets in a spreadsheet" }
+      ],
+      "maturity": "community",
+      "vendor": "xing5",
+      "docsUrl": "https://github.com/xing5/mcp-google-sheets"
+    },
+    {
+      "name": "fetch",
+      "displayName": "Web Fetch",
+      "description": "Fetch any URL and return its content as markdown — no API keys required",
+      "category": "search",
+      "tags": ["search", "web", "fetch", "url", "scrape", "markdown"],
+      "transport": "stdio",
+      "command": "uvx",
+      "args": ["mcp-server-fetch"],
+      "envVars": {},
+      "tools": [
+        { "name": "fetch", "description": "Fetch a URL and return content as markdown" }
+      ],
+      "maturity": "official",
+      "vendor": "MCP Project",
+      "docsUrl": "https://github.com/modelcontextprotocol/servers/tree/main/src/fetch"
+    },
+    {
+      "name": "crawl4ai",
+      "displayName": "Crawl4AI",
+      "description": "Local Docker-based web crawler — scrape pages as markdown/HTML, take screenshots, extract PDFs, and execute JS. No API keys required.",
+      "category": "search",
+      "tags": ["search", "web", "crawl", "scrape", "markdown", "screenshot", "docker"],
+      "transport": "sse",
+      "url": "http://localhost:11235/mcp/sse",
+      "envVars": {},
+      "tools": [
+        { "name": "md", "description": "Crawl a URL and return content as markdown" },
+        { "name": "html", "description": "Crawl a URL and return raw HTML" },
+        { "name": "screenshot", "description": "Take a screenshot of a webpage" },
+        { "name": "pdf", "description": "Generate a PDF of a webpage" },
+        { "name": "execute_js", "description": "Execute JavaScript on a page and return results" },
+        { "name": "crawl", "description": "Crawl a URL with full configuration options" },
+        { "name": "ask", "description": "Ask a question about a webpage's content" }
+      ],
+      "maturity": "community",
+      "vendor": "unclecode",
+      "docsUrl": "https://github.com/unclecode/crawl4ai"
+    },
+    {
+      "type": "prompt",
+      "name": "tone-guide",
+      "displayName": "Tone Guide",
+      "description": "Warm, professional communication style for customer-facing agents",
+      "category": "support",
+      "tags": ["support", "tone", "communication", "style"],
+      "content": "## Communication Style\n\n- Warm, professional, and concise\n- Use short paragraphs and bullet points for clarity\n- Acknowledge the customer's frustration before problem-solving\n- Avoid jargon — use plain language\n- End each interaction with a clear next step or confirmation",
+      "maturity": "official",
+      "vendor": "Operor"
+    },
+    {
+      "type": "prompt",
+      "name": "escalation-protocol",
+      "displayName": "Escalation Protocol",
+      "description": "Standard escalation behavior for customer support agents",
+      "category": "support",
+      "tags": ["support", "escalation", "handoff"],
+      "content": "## Escalation Protocol\n\n- If the customer asks for a human agent, acknowledge their request and provide handoff instructions\n- If the issue involves a refund over the policy limit, escalate to the billing team\n- If the customer is abusive or threatening, politely end the conversation and escalate\n- Use the phrase: \"Let me connect you with a team member who can help with this.\"",
+      "maturity": "official",
+      "vendor": "Operor"
+    }
+  ]
+}

package/src/MCPSkill.ts

@@ -0,0 +1,154 @@
+import type { Skill, Tool } from '@operor/core';
+import { createMCPClient } from '@ai-sdk/mcp';
+import type { MCPSkillConfig } from './config.js';
+import { resolveEnvVars, resolveEnvRecord } from './config.js';
+
+export class MCPSkill implements Skill {
+  public readonly name: string;
+  public tools: Record<string, Tool> = {};
+  private client: any = null;
+  private ready = false;
+  private config: MCPSkillConfig;
+
+  constructor(config: MCPSkillConfig) {
+    this.config = config;
+    this.name = config.name;
+  }
+
+  async initialize(): Promise<void> {
+    if (this.ready) return;
+    const transport = await this.createTransport();
+
+    this.client = await createMCPClient({ transport });
+
+    // Discover tools via the AI SDK MCP client
+    const mcpTools = await this.client.tools();
+    const prefix = this.config.toolPrefix ?? this.name;
+
+    for (const [toolName, tool] of Object.entries(mcpTools) as [string, any][]) {
+      const prefixedName = `${prefix}__${toolName}`;
+
+      // Extract the JSON Schema from the AI SDK tool's parameters
+      const parameters = this.extractParameters(tool);
+
+      this.tools[prefixedName] = {
+        name: prefixedName,
+        description: tool.description || '',
+        parameters,
+        execute: async (params: any) => {
+          // Call the AI SDK tool's execute function directly
+          const result = await tool.execute(params, { toolCallId: `call_${Date.now()}` });
+          // MCP tools return { content: [...], isError: true } on failure
+          // instead of throwing — surface these as real errors
+          if (result && typeof result === 'object' && result.isError) {
+            const msg = result.content?.[0]?.text
+              || (result.content?.length ? JSON.stringify(result.content) : null)
+              || 'MCP tool returned an error (no details provided)';
+            throw new Error(msg);
+          }
+          return result;
+        },
+      };
+    }
+
+    this.ready = true;
+  }
+
+  isReady(): boolean {
+    return this.ready;
+  }
+
+  async close(): Promise<void> {
+    if (this.client) {
+      await this.client.close();
+      this.client = null;
+    }
+    this.ready = false;
+  }
+
+  /**
+   * Extract parameters from an AI SDK tool into JSON Schema format.
+   * The @ai-sdk/mcp client exposes the schema as `inputSchema` (a jsonSchema()
+   * wrapper with a `.jsonSchema` getter), while older/test code may use
+   * `parameters` directly.
+   */
+  private extractParameters(tool: any): Record<string, any> {
+    // AI SDK MCP tools use `inputSchema` (a jsonSchema() wrapper)
+    const schema = tool.inputSchema ?? tool.parameters;
+    if (schema) {
+      // jsonSchema() wrapper — has a `.jsonSchema` getter
+      if (schema.jsonSchema) {
+        return schema.jsonSchema;
+      }
+      // Plain JSON Schema object
+      if (schema.type === 'object' && schema.properties) {
+        return schema;
+      }
+    }
+    return { type: 'object', properties: {} };
+  }
+
+  /**
+   * Create the appropriate transport based on config.
+   */
+  private async createTransport(): Promise<any> {
+    switch (this.config.transport) {
+      case 'stdio':
+        return await this.createStdioTransport();
+      case 'http':
+        return this.createHttpTransport();
+      case 'sse':
+        return this.createSseTransport();
+      default:
+        throw new Error(`Unknown transport type: ${this.config.transport}`);
+    }
+  }
+
+  private async createStdioTransport(): Promise<any> {
+    if (!this.config.command) {
+      throw new Error(`Skill "${this.name}": stdio transport requires a "command" field`);
+    }
+
+    // Resolve env vars in args
+    const args = this.config.args?.map(resolveEnvVars) ?? [];
+
+    // Resolve env vars in env record
+    const env = this.config.env ? resolveEnvRecord(this.config.env) : undefined;
+
+    // ESM dynamic import for @modelcontextprotocol/sdk stdio transport
+    const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+    return new StdioClientTransport({
+      command: this.config.command,
+      args,
+      env: env ? { ...process.env, ...env } : undefined,
+    });
+  }
+
+  private createHttpTransport(): any {
+    if (!this.config.url) {
+      throw new Error(`Skill "${this.name}": http transport requires a "url" field`);
+    }
+
+    const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : undefined;
+
+    return {
+      type: 'http' as const,
+      url: resolveEnvVars(this.config.url),
+      headers,
+    };
+  }
+
+  private createSseTransport(): any {
+    if (!this.config.url) {
+      throw new Error(`Skill "${this.name}": sse transport requires a "url" field`);
+    }
+
+    const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : undefined;
+
+    return {
+      type: 'sse' as const,
+      url: resolveEnvVars(this.config.url),
+      headers,
+    };
+  }
+}

package/src/PromptSkill.ts

@@ -0,0 +1,38 @@
+import type { Skill, Tool } from '@operor/core';
+import type { PromptSkillConfig } from './config.js';
+
+export class PromptSkill implements Skill {
+  public readonly name: string;
+  public readonly tools: Record<string, Tool> = {};
+  private ready = false;
+  private _config: PromptSkillConfig;
+
+  constructor(config: PromptSkillConfig) {
+    this._config = config;
+    this.name = config.name;
+  }
+
+  async initialize(): Promise<void> {
+    if (this.ready) return;
+    if (!this._config.content?.trim()) {
+      throw new Error(`Prompt skill "${this.name}": content must be a non-empty string`);
+    }
+    this.ready = true;
+  }
+
+  isReady(): boolean {
+    return this.ready;
+  }
+
+  async close(): Promise<void> {
+    this.ready = false;
+  }
+
+  getContent(): string {
+    return this._config.content;
+  }
+
+  getConfig(): PromptSkillConfig {
+    return { ...this._config };
+  }
+}