@coldiq/mcp 0.3.15 → 0.3.16

package/dist/index.js

@@ -24,6 +24,8 @@ import { getSessionUsageName, getSessionUsageDescription, getSessionUsageSchema,
 import { extractPostEngagementName, extractPostEngagementDescription, extractPostEngagementSchema, extractPostEngagementHandler, } from './tools/extract-post-engagement.js';
 import { getPlaceReviewsName, getPlaceReviewsDescription, getPlaceReviewsSchema, getPlaceReviewsHandler, } from './tools/get-place-reviews.js';
 import { listDataSourcesName, listDataSourcesDescription, listDataSourcesSchema, listDataSourcesHandler, } from './tools/list-data-sources.js';
+import { listSkillsName, listSkillsDescription, listSkillsSchema, listSkillsHandler, } from './tools/list-skills.js';
+import { loadSkillName, loadSkillDescription, loadSkillSchema, loadSkillHandler, } from './tools/load-skill.js';
 // Initialize HTTP client (reads env vars)
 initClient();
 const server = new McpServer({
@@ -62,6 +64,8 @@ server.tool(fetchPageContentName, fetchPageContentDescription, fetchPageContentS
 server.tool(getCreditBalanceName, getCreditBalanceDescription, getCreditBalanceSchema, getCreditBalanceHandler);
 server.tool(getSessionUsageName, getSessionUsageDescription, getSessionUsageSchema, getSessionUsageHandler);
 server.tool(listDataSourcesName, listDataSourcesDescription, listDataSourcesSchema, listDataSourcesHandler);
+server.tool(listSkillsName, listSkillsDescription, listSkillsSchema, listSkillsHandler);
+server.tool(loadSkillName, loadSkillDescription, loadSkillSchema, loadSkillHandler);
 server.tool(extractPostEngagementName, extractPostEngagementDescription, extractPostEngagementSchema, extractPostEngagementHandler);
 server.tool(getPlaceReviewsName, getPlaceReviewsDescription, getPlaceReviewsSchema, getPlaceReviewsHandler);
 // Connect via stdio transport

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/skills.d.ts

@@ -0,0 +1,20 @@
+export interface SkillEntry {
+    name: string;
+    description: string;
+    url: string;
+    digest?: string;
+}
+/** Test seam: clear in-memory caches. */
+export declare function __resetSkillsCache(): void;
+/** The catalog: each skill's name + one-line description (no bodies). */
+export declare function listSkills(): Promise<{
+    name: string;
+    description: string;
+}[]>;
+/**
+ * Full playbook body for `name`. Any `resources/<file>.md` the skill references
+ * is fetched and appended so the returned document is self-contained (agents
+ * reached over MCP can't follow the relative links themselves).
+ */
+export declare function loadSkill(name: string): Promise<string>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAUD,yCAAyC;AACzC,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AA+BD,yEAAyE;AACzE,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAGnF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B7D"}

package/dist/skills.js

@@ -0,0 +1,89 @@
+// ColdIQ GTM skills, served over MCP.
+//
+// Skills are step-by-step playbooks authored in the coldiq-marketplace-skills
+// repo. Claude Code and Cursor load them natively (progressive disclosure), but
+// agents without a skills loader (Codex, Windsurf, Cline, …) can't. Since every
+// agent that installs this MCP gets these two tools, the MCP is the universal
+// delivery channel: list_skills surfaces the catalog, load_skill fetches one
+// playbook on demand.
+//
+// Source is the repo's discovery index on GitHub raw, so a push to the skills
+// repo updates what every agent sees — no MCP republish needed. Override with
+// COLDIQ_SKILLS_INDEX_URL.
+const DEFAULT_INDEX_URL = 'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json';
+const INDEX_TTL_MS = 10 * 60 * 1000; // re-fetch the catalog at most every 10 min
+let _indexCache = null;
+const _bodyCache = new Map();
+/** Test seam: clear in-memory caches. */
+export function __resetSkillsCache() {
+    _indexCache = null;
+    _bodyCache.clear();
+}
+function indexUrl() {
+    return process.env.COLDIQ_SKILLS_INDEX_URL || DEFAULT_INDEX_URL;
+}
+async function fetchText(url) {
+    const res = await fetch(url, { headers: { 'user-agent': 'coldiq-mcp' } });
+    if (!res.ok)
+        throw new Error(`request to ${url} failed (HTTP ${res.status})`);
+    return await res.text();
+}
+async function getIndex() {
+    if (_indexCache && Date.now() - _indexCache.fetchedAt < INDEX_TTL_MS) {
+        return _indexCache.skills;
+    }
+    const parsed = JSON.parse(await fetchText(indexUrl()));
+    const raw = Array.isArray(parsed?.skills) ? parsed.skills : [];
+    const skills = raw
+        .filter((s) => !!s && typeof s === 'object')
+        .map((s) => ({
+        name: String(s.name ?? ''),
+        description: String(s.description ?? ''),
+        url: String(s.url ?? ''),
+        digest: typeof s.digest === 'string' ? s.digest : undefined,
+    }))
+        .filter((s) => s.name && s.url);
+    _indexCache = { skills, fetchedAt: Date.now() };
+    return skills;
+}
+/** The catalog: each skill's name + one-line description (no bodies). */
+export async function listSkills() {
+    const skills = await getIndex();
+    return skills.map((s) => ({ name: s.name, description: s.description }));
+}
+/**
+ * Full playbook body for `name`. Any `resources/<file>.md` the skill references
+ * is fetched and appended so the returned document is self-contained (agents
+ * reached over MCP can't follow the relative links themselves).
+ */
+export async function loadSkill(name) {
+    const skills = await getIndex();
+    const entry = skills.find((s) => s.name === name);
+    if (!entry) {
+        throw new Error(`unknown skill "${name}". Available: ${skills.map((s) => s.name).join(', ')}`);
+    }
+    if (_bodyCache.has(entry.url))
+        return _bodyCache.get(entry.url);
+    const body = await fetchText(entry.url);
+    const refs = new Set();
+    for (const m of body.matchAll(/resources\/([A-Za-z0-9._-]+\.md)/g))
+        refs.add(m[1]);
+    let combined = body;
+    if (refs.size > 0) {
+        const baseDir = entry.url.replace(/\/[^/]*$/, ''); // strip trailing SKILL.md
+        const sections = [];
+        for (const ref of refs) {
+            try {
+                const text = await fetchText(`${baseDir}/resources/${ref}`);
+                sections.push(`\n\n---\n\n## Resource: resources/${ref}\n\n${text.trim()}`);
+            }
+            catch {
+                // A missing resource shouldn't fail the whole skill load.
+            }
+        }
+        combined = body.replace(/\s+$/, '') + sections.join('') + '\n';
+    }
+    _bodyCache.set(entry.url, combined);
+    return combined;
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-skills.d.ts

@@ -0,0 +1,17 @@
+export declare const listSkillsName = "list_skills";
+export declare const listSkillsDescription: string;
+export declare const listSkillsSchema: {};
+export declare function listSkillsHandler(_input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=list-skills.d.ts.map

package/dist/tools/list-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-skills.d.ts","sourceRoot":"","sources":["../../src/tools/list-skills.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,gBAAgB,CAAA;AAE3C,eAAO,MAAM,qBAAqB,QAMkE,CAAA;AAEpG,eAAO,MAAM,gBAAgB,IAAK,CAAA;AAElC,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAUtE"}

package/dist/tools/list-skills.js

@@ -0,0 +1,22 @@
+import { listSkills } from '../skills.js';
+export const listSkillsName = 'list_skills';
+export const listSkillsDescription = 'List the available ColdIQ GTM playbooks ("skills") — step-by-step expert workflows for go-to-market ' +
+    'tasks: building a TAM, Apollo / company / people search, contact enrichment and email waterfalls, ' +
+    'signal detection, ICP & personas, cold-email copy, campaign delivery, and more. Returns each skill\'s ' +
+    'name and a one-line description of when to use it. Call this when starting a prospecting / outreach / ' +
+    'GTM task to check for a relevant playbook, then call load_skill to read the full step-by-step guide. ' +
+    '(Claude Code and Cursor load these skills natively; on other agents this is how you reach them.)';
+export const listSkillsSchema = {};
+export async function listSkillsHandler(_input) {
+    try {
+        const skills = await listSkills();
+        return { content: [{ type: 'text', text: JSON.stringify({ data: skills }) }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Could not load the ColdIQ skills catalog: ${err.message}` }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-skills.js.map

package/dist/tools/list-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-skills.js","sourceRoot":"","sources":["../../src/tools/list-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAA;AAE3C,MAAM,CAAC,MAAM,qBAAqB,GAChC,sGAAsG;IACtG,oGAAoG;IACpG,wGAAwG;IACxG,wGAAwG;IACxG,uGAAuG;IACvG,kGAAkG,CAAA;AAEpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAA+B;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAA;QACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IACzF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,6CAA8C,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;YAC5I,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/tools/load-skill.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const loadSkillName = "load_skill";
+export declare const loadSkillDescription: string;
+export declare const loadSkillSchema: {
+    name: z.ZodString;
+};
+export declare function loadSkillHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=load-skill.d.ts.map

package/dist/tools/load-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill.d.ts","sourceRoot":"","sources":["../../src/tools/load-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,eAAO,MAAM,oBAAoB,QAIK,CAAA;AAEtC,eAAO,MAAM,eAAe;;CAI3B,CAAA;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAcpE"}

package/dist/tools/load-skill.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { loadSkill } from '../skills.js';
+export const loadSkillName = 'load_skill';
+export const loadSkillDescription = 'Load the full ColdIQ GTM playbook ("skill") by name — the complete step-by-step expert workflow, ' +
+    'including which ColdIQ tools/endpoints to call at each step. Call list_skills first to get the available ' +
+    'names. The returned guide (with any referenced reference docs inlined) tells you exactly how to run the ' +
+    'task using the other ColdIQ tools.';
+export const loadSkillSchema = {
+    name: z
+        .string()
+        .describe('The skill name from list_skills, e.g. "contact-enrichment", "apollo-search", or "tam-scoring".'),
+};
+export async function loadSkillHandler(input) {
+    const name = String(input.name ?? '').trim();
+    if (!name) {
+        return {
+            content: [{ type: 'text', text: 'Provide a skill "name" — call list_skills to see the available skills.' }],
+            isError: true,
+        };
+    }
+    try {
+        const body = await loadSkill(name);
+        return { content: [{ type: 'text', text: body }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: err.message }], isError: true };
+    }
+}
+//# sourceMappingURL=load-skill.js.map

package/dist/tools/load-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill.js","sourceRoot":"","sources":["../../src/tools/load-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAC/B,mGAAmG;IACnG,2GAA2G;IAC3G,0GAA0G;IAC1G,oCAAoC,CAAA;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,gGAAgG,CAAC;CAC9G,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA8B;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wEAAwE,EAAE,CAAC;YACpH,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC9F,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -158,6 +158,20 @@ import {
   listDataSourcesHandler,
 } from './tools/list-data-sources.js'
 
+import {
+  listSkillsName,
+  listSkillsDescription,
+  listSkillsSchema,
+  listSkillsHandler,
+} from './tools/list-skills.js'
+
+import {
+  loadSkillName,
+  loadSkillDescription,
+  loadSkillSchema,
+  loadSkillHandler,
+} from './tools/load-skill.js'
+
 // Initialize HTTP client (reads env vars)
 initClient()
 
@@ -201,6 +215,8 @@ server.tool(fetchPageContentName, fetchPageContentDescription, fetchPageContentS
 server.tool(getCreditBalanceName, getCreditBalanceDescription, getCreditBalanceSchema, getCreditBalanceHandler)
 server.tool(getSessionUsageName, getSessionUsageDescription, getSessionUsageSchema, getSessionUsageHandler)
 server.tool(listDataSourcesName, listDataSourcesDescription, listDataSourcesSchema, listDataSourcesHandler)
+server.tool(listSkillsName, listSkillsDescription, listSkillsSchema, listSkillsHandler)
+server.tool(loadSkillName, loadSkillDescription, loadSkillSchema, loadSkillHandler)
 server.tool(extractPostEngagementName, extractPostEngagementDescription, extractPostEngagementSchema, extractPostEngagementHandler)
 server.tool(getPlaceReviewsName, getPlaceReviewsDescription, getPlaceReviewsSchema, getPlaceReviewsHandler)
 

package/src/skills.ts

@@ -0,0 +1,108 @@
+// ColdIQ GTM skills, served over MCP.
+//
+// Skills are step-by-step playbooks authored in the coldiq-marketplace-skills
+// repo. Claude Code and Cursor load them natively (progressive disclosure), but
+// agents without a skills loader (Codex, Windsurf, Cline, …) can't. Since every
+// agent that installs this MCP gets these two tools, the MCP is the universal
+// delivery channel: list_skills surfaces the catalog, load_skill fetches one
+// playbook on demand.
+//
+// Source is the repo's discovery index on GitHub raw, so a push to the skills
+// repo updates what every agent sees — no MCP republish needed. Override with
+// COLDIQ_SKILLS_INDEX_URL.
+
+const DEFAULT_INDEX_URL =
+  'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json'
+const INDEX_TTL_MS = 10 * 60 * 1000 // re-fetch the catalog at most every 10 min
+
+export interface SkillEntry {
+  name: string
+  description: string
+  url: string
+  digest?: string
+}
+
+interface CachedIndex {
+  skills: SkillEntry[]
+  fetchedAt: number
+}
+
+let _indexCache: CachedIndex | null = null
+const _bodyCache = new Map<string, string>()
+
+/** Test seam: clear in-memory caches. */
+export function __resetSkillsCache(): void {
+  _indexCache = null
+  _bodyCache.clear()
+}
+
+function indexUrl(): string {
+  return process.env.COLDIQ_SKILLS_INDEX_URL || DEFAULT_INDEX_URL
+}
+
+async function fetchText(url: string): Promise<string> {
+  const res = await fetch(url, { headers: { 'user-agent': 'coldiq-mcp' } })
+  if (!res.ok) throw new Error(`request to ${url} failed (HTTP ${res.status})`)
+  return await res.text()
+}
+
+async function getIndex(): Promise<SkillEntry[]> {
+  if (_indexCache && Date.now() - _indexCache.fetchedAt < INDEX_TTL_MS) {
+    return _indexCache.skills
+  }
+  const parsed = JSON.parse(await fetchText(indexUrl()))
+  const raw = Array.isArray(parsed?.skills) ? parsed.skills : []
+  const skills: SkillEntry[] = raw
+    .filter((s: unknown): s is Record<string, unknown> => !!s && typeof s === 'object')
+    .map((s: Record<string, unknown>) => ({
+      name: String(s.name ?? ''),
+      description: String(s.description ?? ''),
+      url: String(s.url ?? ''),
+      digest: typeof s.digest === 'string' ? s.digest : undefined,
+    }))
+    .filter((s: SkillEntry) => s.name && s.url)
+  _indexCache = { skills, fetchedAt: Date.now() }
+  return skills
+}
+
+/** The catalog: each skill's name + one-line description (no bodies). */
+export async function listSkills(): Promise<{ name: string; description: string }[]> {
+  const skills = await getIndex()
+  return skills.map((s) => ({ name: s.name, description: s.description }))
+}
+
+/**
+ * Full playbook body for `name`. Any `resources/<file>.md` the skill references
+ * is fetched and appended so the returned document is self-contained (agents
+ * reached over MCP can't follow the relative links themselves).
+ */
+export async function loadSkill(name: string): Promise<string> {
+  const skills = await getIndex()
+  const entry = skills.find((s) => s.name === name)
+  if (!entry) {
+    throw new Error(`unknown skill "${name}". Available: ${skills.map((s) => s.name).join(', ')}`)
+  }
+  if (_bodyCache.has(entry.url)) return _bodyCache.get(entry.url) as string
+
+  const body = await fetchText(entry.url)
+  const refs = new Set<string>()
+  for (const m of body.matchAll(/resources\/([A-Za-z0-9._-]+\.md)/g)) refs.add(m[1])
+
+  let combined = body
+  if (refs.size > 0) {
+    const baseDir = entry.url.replace(/\/[^/]*$/, '') // strip trailing SKILL.md
+    const sections: string[] = []
+    for (const ref of refs) {
+      try {
+        const text = await fetchText(`${baseDir}/resources/${ref}`)
+        sections.push(`\n\n---\n\n## Resource: resources/${ref}\n\n${text.trim()}`)
+      } catch {
+        // A missing resource shouldn't fail the whole skill load.
+      }
+    }
+    combined = body.replace(/\s+$/, '') + sections.join('') + '\n'
+  }
+
+  _bodyCache.set(entry.url, combined)
+  return combined
+}

package/src/tools/list-skills.ts

@@ -0,0 +1,25 @@
+import { listSkills } from '../skills.js'
+
+export const listSkillsName = 'list_skills'
+
+export const listSkillsDescription =
+  'List the available ColdIQ GTM playbooks ("skills") — step-by-step expert workflows for go-to-market ' +
+  'tasks: building a TAM, Apollo / company / people search, contact enrichment and email waterfalls, ' +
+  'signal detection, ICP & personas, cold-email copy, campaign delivery, and more. Returns each skill\'s ' +
+  'name and a one-line description of when to use it. Call this when starting a prospecting / outreach / ' +
+  'GTM task to check for a relevant playbook, then call load_skill to read the full step-by-step guide. ' +
+  '(Claude Code and Cursor load these skills natively; on other agents this is how you reach them.)'
+
+export const listSkillsSchema = {}
+
+export async function listSkillsHandler(_input: Record<string, unknown>) {
+  try {
+    const skills = await listSkills()
+    return { content: [{ type: 'text' as const, text: JSON.stringify({ data: skills }) }] }
+  } catch (err) {
+    return {
+      content: [{ type: 'text' as const, text: JSON.stringify({ error: `Could not load the ColdIQ skills catalog: ${(err as Error).message}` }) }],
+      isError: true,
+    }
+  }
+}

package/src/tools/load-skill.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod'
+import { loadSkill } from '../skills.js'
+
+export const loadSkillName = 'load_skill'
+
+export const loadSkillDescription =
+  'Load the full ColdIQ GTM playbook ("skill") by name — the complete step-by-step expert workflow, ' +
+  'including which ColdIQ tools/endpoints to call at each step. Call list_skills first to get the available ' +
+  'names. The returned guide (with any referenced reference docs inlined) tells you exactly how to run the ' +
+  'task using the other ColdIQ tools.'
+
+export const loadSkillSchema = {
+  name: z
+    .string()
+    .describe('The skill name from list_skills, e.g. "contact-enrichment", "apollo-search", or "tam-scoring".'),
+}
+
+export async function loadSkillHandler(input: Record<string, unknown>) {
+  const name = String(input.name ?? '').trim()
+  if (!name) {
+    return {
+      content: [{ type: 'text' as const, text: 'Provide a skill "name" — call list_skills to see the available skills.' }],
+      isError: true,
+    }
+  }
+  try {
+    const body = await loadSkill(name)
+    return { content: [{ type: 'text' as const, text: body }] }
+  } catch (err) {
+    return { content: [{ type: 'text' as const, text: (err as Error).message }], isError: true }
+  }
+}

package/tests/skills.test.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
+import { listSkills, loadSkill, __resetSkillsCache } from '../src/skills.js'
+
+const INDEX = {
+  $schema: 'https://schemas.agentskills.io/discovery/0.2.0/schema.json',
+  name: 'coldiq',
+  skills: [
+    {
+      name: 'contact-enrichment',
+      type: 'skill-md',
+      description: 'Enrich contacts with emails and phones.',
+      url: 'https://raw.example/skills/contact-enrichment/SKILL.md',
+      digest: 'sha256:abc',
+    },
+    {
+      name: 'coldiq-search-enrich',
+      type: 'skill-md',
+      description: 'Search and enrich at scale.',
+      url: 'https://raw.example/skills/lima-data-api/SKILL.md',
+    },
+  ],
+}
+
+const BODY_WITH_RES =
+  '# Contact enrichment\n\nSee [resources/async-job-pattern.md](resources/async-job-pattern.md) and ' +
+  '[resources/credit-optimization.md](resources/credit-optimization.md).\n'
+
+function mockFetch(map: Record<string, { status?: number; body: string }>) {
+  return vi.fn(async (url: string | URL | Request) => {
+    const u = String(url)
+    const hit = map[u]
+    if (!hit) return { ok: false, status: 404, text: async () => 'not found' } as Response
+    const status = hit.status ?? 200
+    return { ok: status >= 200 && status < 300, status, text: async () => hit.body } as Response
+  })
+}
+
+const originalFetch = globalThis.fetch
+
+describe('skills module', () => {
+  beforeEach(() => {
+    __resetSkillsCache()
+    delete process.env.COLDIQ_SKILLS_INDEX_URL
+  })
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+    vi.restoreAllMocks()
+  })
+
+  it('listSkills returns name + description from the index', async () => {
+    globalThis.fetch = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+    }) as typeof fetch
+    const skills = await listSkills()
+    expect(skills).toHaveLength(2)
+    expect(skills[0]).toEqual({ name: 'contact-enrichment', description: 'Enrich contacts with emails and phones.' })
+    expect(skills.map((s) => s.name)).toContain('coldiq-search-enrich')
+  })
+
+  it('honors COLDIQ_SKILLS_INDEX_URL override', async () => {
+    process.env.COLDIQ_SKILLS_INDEX_URL = 'https://custom/index.json'
+    globalThis.fetch = mockFetch({ 'https://custom/index.json': { body: JSON.stringify(INDEX) } }) as typeof fetch
+    const skills = await listSkills()
+    expect(skills).toHaveLength(2)
+  })
+
+  it('caches the index (one network call across two listSkills)', async () => {
+    const f = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+    })
+    globalThis.fetch = f as typeof fetch
+    await listSkills()
+    await listSkills()
+    expect(f).toHaveBeenCalledTimes(1)
+  })
+
+  it('loadSkill returns the body with referenced resources inlined', async () => {
+    globalThis.fetch = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+      'https://raw.example/skills/contact-enrichment/SKILL.md': { body: BODY_WITH_RES },
+      'https://raw.example/skills/contact-enrichment/resources/async-job-pattern.md': { body: 'POLL LOOP DOC' },
+      'https://raw.example/skills/contact-enrichment/resources/credit-optimization.md': { body: 'CREDIT DOC' },
+    }) as typeof fetch
+    const doc = await loadSkill('contact-enrichment')
+    expect(doc).toContain('# Contact enrichment')
+    expect(doc).toContain('## Resource: resources/async-job-pattern.md')
+    expect(doc).toContain('POLL LOOP DOC')
+    expect(doc).toContain('## Resource: resources/credit-optimization.md')
+    expect(doc).toContain('CREDIT DOC')
+  })
+
+  it('loadSkill tolerates a missing resource (skips it, still returns body)', async () => {
+    globalThis.fetch = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+      'https://raw.example/skills/contact-enrichment/SKILL.md': { body: BODY_WITH_RES },
+      // resources intentionally 404
+    }) as typeof fetch
+    const doc = await loadSkill('contact-enrichment')
+    expect(doc).toContain('# Contact enrichment')
+    expect(doc).not.toContain('POLL LOOP DOC')
+  })
+
+  it('loadSkill resolves folder≠name via the index url', async () => {
+    globalThis.fetch = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+      'https://raw.example/skills/lima-data-api/SKILL.md': { body: '# Search & enrich\n' },
+    }) as typeof fetch
+    const doc = await loadSkill('coldiq-search-enrich')
+    expect(doc).toContain('# Search & enrich')
+  })
+
+  it('loadSkill throws a helpful error for an unknown skill', async () => {
+    globalThis.fetch = mockFetch({
+      'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json': {
+        body: JSON.stringify(INDEX),
+      },
+    }) as typeof fetch
+    await expect(loadSkill('does-not-exist')).rejects.toThrow(/unknown skill/i)
+  })
+})

package/tests/tools/list-skills.test.ts

@@ -0,0 +1,44 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
+import {
+  listSkillsHandler,
+  listSkillsName,
+  listSkillsSchema,
+} from '../../src/tools/list-skills.js'
+import { __resetSkillsCache } from '../../src/skills.js'
+
+const INDEX_URL =
+  'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json'
+const originalFetch = globalThis.fetch
+
+describe('list_skills handler', () => {
+  beforeEach(() => __resetSkillsCache())
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+    vi.restoreAllMocks()
+  })
+
+  it('is a zero-arg tool', () => {
+    expect(listSkillsName).toBe('list_skills')
+    expect(listSkillsSchema).toEqual({})
+  })
+
+  it('returns the catalog as { data: [...] }', async () => {
+    globalThis.fetch = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      text: async () =>
+        JSON.stringify({ skills: [{ name: 'tam-scoring', description: 'Score a TAM.', url: 'https://x/SKILL.md' }] }),
+    })) as unknown as typeof fetch
+    const res = await listSkillsHandler({})
+    expect(res.isError).toBeFalsy()
+    const parsed = JSON.parse(res.content[0].text)
+    expect(parsed.data).toEqual([{ name: 'tam-scoring', description: 'Score a TAM.' }])
+  })
+
+  it('returns an error result (not a throw) when the index is unreachable', async () => {
+    globalThis.fetch = vi.fn(async () => ({ ok: false, status: 500, text: async () => 'err' })) as unknown as typeof fetch
+    const res = await listSkillsHandler({})
+    expect(res.isError).toBe(true)
+    expect(JSON.parse(res.content[0].text).error).toMatch(/could not load/i)
+  })
+})

package/tests/tools/load-skill.test.ts

@@ -0,0 +1,53 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
+import { loadSkillHandler, loadSkillName, loadSkillSchema } from '../../src/tools/load-skill.js'
+import { __resetSkillsCache } from '../../src/skills.js'
+
+const INDEX_URL =
+  'https://raw.githubusercontent.com/Cold-IQ/coldiq-marketplace-skills/main/.well-known/agent-skills/index.json'
+
+function mockFetch(map: Record<string, string>) {
+  return vi.fn(async (url: string | URL | Request) => {
+    const body = map[String(url)]
+    return { ok: body !== undefined, status: body !== undefined ? 200 : 404, text: async () => body ?? 'nf' } as Response
+  })
+}
+const originalFetch = globalThis.fetch
+
+describe('load_skill handler', () => {
+  beforeEach(() => __resetSkillsCache())
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+    vi.restoreAllMocks()
+  })
+
+  it('declares a required name arg', () => {
+    expect(loadSkillName).toBe('load_skill')
+    expect(Object.keys(loadSkillSchema)).toContain('name')
+  })
+
+  it('returns the skill body as text', async () => {
+    globalThis.fetch = mockFetch({
+      [INDEX_URL]: JSON.stringify({ skills: [{ name: 'apollo-search', description: 'd', url: 'https://x/skills/apollo-search/SKILL.md' }] }),
+      'https://x/skills/apollo-search/SKILL.md': '# Apollo search\nstep 1',
+    }) as typeof fetch
+    const res = await loadSkillHandler({ name: 'apollo-search' })
+    expect(res.isError).toBeFalsy()
+    expect(res.content[0].text).toContain('# Apollo search')
+  })
+
+  it('errors (not throws) on a missing name', async () => {
+    const res = await loadSkillHandler({})
+    expect(res.isError).toBe(true)
+    expect(res.content[0].text).toMatch(/list_skills/)
+  })
+
+  it('errors with the available list on an unknown skill', async () => {
+    globalThis.fetch = mockFetch({
+      [INDEX_URL]: JSON.stringify({ skills: [{ name: 'apollo-search', description: 'd', url: 'https://x/SKILL.md' }] }),
+    }) as typeof fetch
+    const res = await loadSkillHandler({ name: 'nope' })
+    expect(res.isError).toBe(true)
+    expect(res.content[0].text).toMatch(/unknown skill/i)
+    expect(res.content[0].text).toMatch(/apollo-search/)
+  })
+})