wolfpack-mcp 1.0.38 → 1.0.39

package/dist/client.js

@@ -9,6 +9,14 @@ export class WolfpackClient {
     constructor() {
         this.api = new ApiClient();
     }
+    /** Build a URL path with optional teamSlug query parameter. */
+    withTeamSlug(path, teamSlug) {
+        const slug = teamSlug || this.projectSlug;
+        if (!slug)
+            return path;
+        const sep = path.includes('?') ? '&' : '?';
+        return `${path}${sep}teamSlug=${encodeURIComponent(slug)}`;
+    }
     /**
      * Fetch and cache the project slug by verifying it exists.
      * Uses the MCP team endpoint to validate the slug.
@@ -158,7 +166,7 @@ export class WolfpackClient {
     }
     async updateWorkProgress(workItemId, description) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/progress`, {
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/progress`), {
                 description,
             });
         }
@@ -171,7 +179,9 @@ export class WolfpackClient {
     }
     async updateWorkItemStatus(workItemId, status) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/status`, { status });
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/status`), {
+                status,
+            });
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -182,7 +192,7 @@ export class WolfpackClient {
     }
     async updateWorkItemAssignee(workItemId, data) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/assignee`, data);
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/assignee`), data);
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -193,7 +203,9 @@ export class WolfpackClient {
     }
     async updateWorkItemTitle(workItemId, title) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/title`, { title });
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/title`), {
+                title,
+            });
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -204,7 +216,7 @@ export class WolfpackClient {
     }
     async updateWorkItemInitiative(workItemId, radarItemId) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/initiative`, { radarItemId });
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/initiative`), { radarItemId });
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -215,7 +227,7 @@ export class WolfpackClient {
     }
     async pullWorkItem(workItemId, data) {
         try {
-            return await this.api.post(`/work-items/${workItemId}/pull`, data || {});
+            return await this.api.post(this.withTeamSlug(`/work-items/${workItemId}/pull`), data || {});
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -226,7 +238,7 @@ export class WolfpackClient {
     }
     async submitWorkItemForm(workItemId, formValues) {
         try {
-            return await this.api.put(`/work-items/${workItemId}/form`, {
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/form`), {
                 formValues,
             });
         }
@@ -349,7 +361,7 @@ export class WolfpackClient {
         return this.api.post('/issues', { ...rest, teamSlug });
     }
     async updateIssue(issueId, data) {
-        return this.api.patch(`/issues/${issueId}`, data);
+        return this.api.patch(this.withTeamSlug(`/issues/${issueId}`), data);
     }
     // Wiki Page methods
     async listWikiPages(options) {
@@ -398,7 +410,7 @@ export class WolfpackClient {
         return this.api.post('/wiki-pages', { ...rest, teamSlug });
     }
     async updateWikiPage(pageId, data) {
-        return this.api.patch(`/wiki-pages/${pageId}`, data);
+        return this.api.patch(this.withTeamSlug(`/wiki-pages/${pageId}`), data);
     }
     // Journal Entry methods
     async listJournalEntries(options) {
@@ -447,20 +459,20 @@ export class WolfpackClient {
         return this.api.post('/journal-entries', { ...rest, teamSlug });
     }
     async updateJournalEntry(entryId, data) {
-        return this.api.patch(`/journal-entries/${entryId}`, data);
+        return this.api.patch(this.withTeamSlug(`/journal-entries/${entryId}`), data);
     }
     // Comment methods
     async listWorkItemComments(workItemId) {
-        return this.api.get(`/work-items/${workItemId}/comments`);
+        return this.api.get(this.withTeamSlug(`/work-items/${workItemId}/comments`));
     }
     async listIssueComments(issueId) {
-        return this.api.get(`/issues/${issueId}/comments`);
+        return this.api.get(this.withTeamSlug(`/issues/${issueId}/comments`));
     }
     async createWorkItemComment(workItemId, data) {
-        return this.api.post(`/work-items/${workItemId}/comments`, data);
+        return this.api.post(this.withTeamSlug(`/work-items/${workItemId}/comments`), data);
     }
     async createIssueComment(issueId, data) {
-        return this.api.post(`/issues/${issueId}/comments`, data);
+        return this.api.post(this.withTeamSlug(`/issues/${issueId}/comments`), data);
     }
     /**
      * Upload an image and get back a URL that can be used in markdown content.
@@ -476,6 +488,32 @@ export class WolfpackClient {
         const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
         return { base64: buffer.toString('base64'), mimeType: contentType };
     }
+    // Skill methods (progressive disclosure)
+    async listSkills() {
+        return this.api.get('/skills');
+    }
+    async getSkill(name) {
+        try {
+            return await this.api.get(`/skills/${encodeURIComponent(name)}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async getSkillResource(skillName, resourceName) {
+        try {
+            return await this.api.get(`/skills/${encodeURIComponent(skillName)}/resources/${encodeURIComponent(resourceName)}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
     close() {
         // No cleanup needed for API client
     }

package/dist/index.js

@@ -43,6 +43,12 @@ async function checkForUpdates() {
     }
     return null;
 }
+// Cross-reference syntax for linking between content items in markdown fields
+const CONTENT_LINKING_HELP = 'CROSS-REFERENCES: In any markdown content, you can link to other items using these patterns: ' +
+    '#123 or #w123 for work items, #i123 for issues, #r123 for initiatives/roadmap, ' +
+    '#j123 for journal entries, #c123 for cases, #p123 for procedures. ' +
+    'Use @username to mention team members (triggers notifications). ' +
+    'Standard markdown links also work: [link text](/project/{slug}/work-items/123).';
 // Work Item schemas
 // Use z.coerce.string() to handle any type coercion issues from MCP args
 const ListWorkItemsSchema = z.object({
@@ -84,7 +90,7 @@ const ListWorkItemsSchema = z.object({
     offset: z.number().optional().describe('Number of items to skip'),
 });
 const GetWorkItemSchema = z.object({
-    work_item_id: z.string().describe('The ID (UUID) or refId (number) of the work item'),
+    work_item_id: z.string().describe('The refId (number) of the work item'),
     project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 const UpdateWorkProgressSchema = z.object({
@@ -147,7 +153,7 @@ const ListRadarItemsSchema = z.object({
     offset: z.number().optional().describe('Number of items to skip'),
 });
 const GetRadarItemSchema = z.object({
-    item_id: z.string().describe('The ID (UUID) or refId (number) of the radar item'),
+    item_id: z.string().describe('The refId (number) of the radar item'),
     project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 // Issue schemas
@@ -184,7 +190,7 @@ const ListIssuesSchema = z.object({
     offset: z.number().optional().describe('Number of items to skip'),
 });
 const GetIssueSchema = z.object({
-    issue_id: z.string().describe('The ID (UUID) or refId (number) of the issue'),
+    issue_id: z.string().describe('The refId (number) of the issue'),
     project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 // Create schemas
@@ -229,7 +235,7 @@ const CreateIssueSchema = z.object({
     actual_behavior: z.string().optional().describe('Actual behavior observed'),
 });
 const UpdateIssueSchema = z.object({
-    issue_id: z.string().describe('The ID (UUID) of the issue to update'),
+    issue_id: z.string().describe('The refId (number) of the issue to update'),
     title: z.string().optional().describe('Updated title'),
     description: z.string().optional().describe('Updated description'),
     status: z
@@ -256,7 +262,7 @@ const ListWikiPagesSchema = z.object({
     offset: z.number().optional().describe('Number of pages to skip'),
 });
 const GetWikiPageSchema = z.object({
-    page_id: z.string().describe('The page UUID or slug'),
+    page_id: z.string().describe('The page slug'),
 });
 const CreateWikiPageSchema = z.object({
     project_slug: z
@@ -275,7 +281,7 @@ const CreateWikiPageSchema = z.object({
     content: z.string().describe('Page content (markdown)'),
 });
 const UpdateWikiPageSchema = z.object({
-    page_id: z.string().describe('The page UUID'),
+    page_id: z.string().describe('The page slug'),
     title: z.string().optional().describe('Updated title'),
     content: z.string().optional().describe('Updated content (markdown)'),
 });
@@ -295,8 +301,8 @@ const ListJournalEntriesSchema = z.object({
     offset: z.number().optional().describe('Number of entries to skip'),
 });
 const GetJournalEntrySchema = z.object({
-    entry_id: z.string().describe('The entry UUID or refId'),
-    project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
+    entry_id: z.string().describe('The entry refId (number)'),
+    project_slug: z.string().optional().describe('Project slug (required for refId lookup)'),
 });
 const CreateJournalEntrySchema = z.object({
     project_slug: z
@@ -305,26 +311,25 @@ const CreateJournalEntrySchema = z.object({
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
     title: z.string().describe('Entry title'),
     content: z.string().describe('Entry content (markdown)'),
-    date: z.string().optional().describe('Entry date (ISO format, defaults to now)'),
 });
 const UpdateJournalEntrySchema = z.object({
-    entry_id: z.string().describe('The entry UUID'),
+    entry_id: z.string().describe('The entry refId (number)'),
     title: z.string().optional().describe('Updated title'),
     content: z.string().optional().describe('Updated content (markdown)'),
 });
 // Comment schemas
 const ListWorkItemCommentsSchema = z.object({
-    work_item_id: z.string().describe('The work item UUID'),
+    work_item_id: z.string().describe('The work item refId (number)'),
 });
 const ListIssueCommentsSchema = z.object({
-    issue_id: z.string().describe('The issue UUID'),
+    issue_id: z.string().describe('The issue refId (number)'),
 });
 const CreateWorkItemCommentSchema = z.object({
-    work_item_id: z.string().describe('The work item UUID'),
+    work_item_id: z.string().describe('The work item refId (number)'),
     content: z.string().describe('Comment content (markdown)'),
 });
 const CreateIssueCommentSchema = z.object({
-    issue_id: z.string().describe('The issue UUID'),
+    issue_id: z.string().describe('The issue refId (number)'),
     content: z.string().describe('Comment content (markdown)'),
 });
 // Image upload schema
@@ -343,6 +348,54 @@ const DownloadImageSchema = z.object({
         .string()
         .describe('The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").'),
 });
+// Skill schemas
+const GetSkillSchema = z.object({
+    skill_name: z.string().describe('The name of the skill to load (e.g. "deploy-app")'),
+});
+const GetSkillResourceSchema = z.object({
+    skill_name: z.string().describe('The name of the skill'),
+    resource_name: z.string().describe('The name of the resource file'),
+});
+// UUID v4 field names to remove from responses.
+// These are internal database IDs that agents should not use.
+// Agents should use refId (sequential int) or slug instead.
+const UUID_FIELDS_TO_STRIP = new Set([
+    'id', // Main entity UUID - replaced by refId or slug
+    'teamId', // Internal team UUID - noise for agents
+    'workItemId', // Cross-reference UUID on Issues - noise
+]);
+// Fields containing user-defined data that should never be recursively processed.
+const PASSTHROUGH_FIELDS = new Set(['formDefinition', 'formValues']);
+// Strip UUID v4 fields from response objects so agents use refId/slug instead.
+// Preserves Clerk user IDs (user_xxx format) and operational fields (categoryId, radarItemId).
+function stripUuids(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(stripUuids);
+    if (typeof obj !== 'object')
+        return obj;
+    const record = obj;
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        // Skip UUID fields
+        if (UUID_FIELDS_TO_STRIP.has(key))
+            continue;
+        // Preserve user-defined data fields as-is (no recursive stripping)
+        if (PASSTHROUGH_FIELDS.has(key)) {
+            result[key] = value;
+            continue;
+        }
+        // Recurse into nested objects/arrays
+        if (typeof value === 'object' && value !== null) {
+            result[key] = stripUuids(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
 // Helper to detect if a work item description contains a plan
 function hasPlan(description) {
     if (!description)
@@ -458,7 +511,7 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_work_item',
-                    description: 'Get a specific work item/task by ID or reference number. Returns full details including description (markdown notes). ' +
+                    description: 'Get a specific work item/task by reference number. Returns full details including description (markdown notes). ' +
                         'Call this before updating to see current content. ' +
                         'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
                         '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
@@ -470,11 +523,11 @@ class WolfpackMCPServer {
                         properties: {
                             work_item_id: {
                                 type: 'string',
-                                description: 'The ID (UUID) or refId (number) of the work item',
+                                description: 'The refId (number) of the work item',
                             },
                             project_slug: {
                                 type: 'string',
-                                description: 'Project slug (required when looking up by refId)',
+                                description: 'Project slug (required for refId lookup)',
                             },
                         },
                         required: ['work_item_id'],
@@ -484,7 +537,8 @@ class WolfpackMCPServer {
                     name: 'update_work_progress',
                     description: 'Update work item description/notes with your progress. WORKFLOW: 1) get_work_item to read current notes 2) Modify the markdown description with new findings/progress 3) Call this with the complete updated description. The full description replaces the existing one. ' +
                         'CRITICAL: NEVER overwrite or remove the original description text. Preserve all existing content exactly as-is. Append your plan below a "---" separator. You may only modify content you previously added (your plan section). ' +
-                        'BEST PRACTICE: Append a plan with markdown checkboxes (- [ ] task). Check off completed tasks (- [x] task) as you progress. Include sections for: Plan (checklist), Approach (strategy), and Notes (discoveries/decisions).',
+                        'BEST PRACTICE: Append a plan with markdown checkboxes (- [ ] task). Check off completed tasks (- [x] task) as you progress. Include sections for: Plan (checklist), Approach (strategy), and Notes (discoveries/decisions). ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -662,18 +716,18 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_radar_item',
-                    description: 'Get a specific radar item (initiative) by ID or refId, including its work items and participants. ' +
+                    description: 'Get a specific radar item (initiative) by reference number, including its work items and participants. ' +
                         'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
                             item_id: {
                                 type: 'string',
-                                description: 'The ID (UUID) or refId (number) of the radar item',
+                                description: 'The refId (number) of the radar item',
                             },
                             project_slug: {
                                 type: 'string',
-                                description: 'Project slug (required when looking up by refId)',
+                                description: 'Project slug (required for refId lookup)',
                             },
                         },
                         required: ['item_id'],
@@ -740,18 +794,18 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_issue',
-                    description: 'Get a specific issue by ID or refId, including comment and attachment counts. ' +
+                    description: 'Get a specific issue by reference number, including comment and attachment counts. ' +
                         'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
                             issue_id: {
                                 type: 'string',
-                                description: 'The ID (UUID) or refId (number) of the issue',
+                                description: 'The refId (number) of the issue',
                             },
                             project_slug: {
                                 type: 'string',
-                                description: 'Project slug (required when looking up by refId)',
+                                description: 'Project slug (required for refId lookup)',
                             },
                         },
                         required: ['issue_id'],
@@ -760,7 +814,8 @@ class WolfpackMCPServer {
                 // Create/Update tools
                 {
                     name: 'create_work_item',
-                    description: 'Create a new work item in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:work_items:create permission.',
+                    description: 'Create a new work item in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:work_items:create permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -815,7 +870,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'create_issue',
-                    description: 'Create a new issue in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:issues:create permission.',
+                    description: 'Create a new issue in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:issues:create permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -848,11 +904,15 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'update_issue',
-                    description: 'Update an existing issue. Requires mcp:issues:update permission.',
+                    description: 'Update an existing issue. Requires mcp:issues:update permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            issue_id: { type: 'string', description: 'The ID (UUID) of the issue to update' },
+                            issue_id: {
+                                type: 'string',
+                                description: 'The refId (number) of the issue to update',
+                            },
                             title: { type: 'string', description: 'Updated title' },
                             description: { type: 'string', description: 'Updated description' },
                             status: {
@@ -904,14 +964,14 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_wiki_page',
-                    description: 'Get a specific wiki/documentation page by ID or slug (URL path). Returns full content in markdown. ' +
+                    description: 'Get a specific wiki/documentation page by slug (URL path). Returns full content in markdown. ' +
                         'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
                             page_id: {
                                 type: 'string',
-                                description: 'The page UUID or slug (URL path like "getting-started")',
+                                description: 'The page slug (URL path like "getting-started")',
                             },
                         },
                         required: ['page_id'],
@@ -919,7 +979,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'create_wiki_page',
-                    description: 'Create a new wiki/documentation page. Use when user wants to "add docs", "create documentation", or "write a guide".',
+                    description: 'Create a new wiki/documentation page. Use when user wants to "add docs", "create documentation", or "write a guide". ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -942,11 +1003,12 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'update_wiki_page',
-                    description: 'Update an existing wiki page. Requires mcp:wiki:update permission.',
+                    description: 'Update an existing wiki page. Requires mcp:wiki:update permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            page_id: { type: 'string', description: 'The page UUID' },
+                            page_id: { type: 'string', description: 'The page slug' },
                             title: { type: 'string', description: 'Updated title' },
                             content: {
                                 type: 'string',
@@ -986,15 +1048,15 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_journal_entry',
-                    description: 'Get a specific journal/log entry by ID or reference number. Returns full content. ' +
+                    description: 'Get a specific journal/log entry by reference number. Returns full content. ' +
                         'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            entry_id: { type: 'string', description: 'The entry UUID or refId' },
+                            entry_id: { type: 'string', description: 'The entry refId (number)' },
                             project_slug: {
                                 type: 'string',
-                                description: 'Project slug (required when looking up by refId)',
+                                description: 'Project slug (required for refId lookup)',
                             },
                         },
                         required: ['entry_id'],
@@ -1002,7 +1064,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'create_journal_entry',
-                    description: 'Create a new journal entry (daily log, standup note, progress update). Use when user wants to "log progress", "write a standup", "add a journal entry", or "record what I did".',
+                    description: 'Create a new journal entry (daily log, standup note, progress update). Use when user wants to "log progress", "write a standup", "add a journal entry", or "record what I did". ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1015,18 +1078,18 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'Entry content (markdown)',
                             },
-                            date: { type: 'string', description: 'Entry date (ISO format, defaults to now)' },
                         },
                         required: ['title', 'content'],
                     },
                 },
                 {
                     name: 'update_journal_entry',
-                    description: 'Update an existing journal entry. Requires mcp:journal:update permission.',
+                    description: 'Update an existing journal entry. Requires mcp:journal:update permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            entry_id: { type: 'string', description: 'The entry UUID' },
+                            entry_id: { type: 'string', description: 'The entry refId (number)' },
                             title: { type: 'string', description: 'Updated title' },
                             content: {
                                 type: 'string',
@@ -1044,7 +1107,7 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            work_item_id: { type: 'string', description: 'The work item UUID' },
+                            work_item_id: { type: 'string', description: 'The work item refId (number)' },
                         },
                         required: ['work_item_id'],
                     },
@@ -1056,7 +1119,7 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            issue_id: { type: 'string', description: 'The issue UUID' },
+                            issue_id: { type: 'string', description: 'The issue refId (number)' },
                         },
                         required: ['issue_id'],
                     },
@@ -1068,11 +1131,12 @@ class WolfpackMCPServer {
                         '2) Completion summaries when moving to "review" (what was done, files changed, testing notes). ' +
                         '3) Important observations or decisions that should be visible in the activity history. ' +
                         'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time. ' +
-                        'Comments are typically not used in personal projects.',
+                        'Comments are typically not used in personal projects. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            work_item_id: { type: 'string', description: 'The work item UUID' },
+                            work_item_id: { type: 'string', description: 'The work item refId (number)' },
                             content: {
                                 type: 'string',
                                 description: 'Comment content (markdown)',
@@ -1083,11 +1147,12 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'create_issue_comment',
-                    description: 'Add a comment to an issue. Requires mcp:comments:create permission.',
+                    description: 'Add a comment to an issue. Requires mcp:comments:create permission. ' +
+                        CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            issue_id: { type: 'string', description: 'The issue UUID' },
+                            issue_id: { type: 'string', description: 'The issue refId (number)' },
                             content: {
                                 type: 'string',
                                 description: 'Comment content (markdown)',
@@ -1138,6 +1203,51 @@ class WolfpackMCPServer {
                         required: ['image_url'],
                     },
                 },
+                // Skill tools (progressive disclosure)
+                {
+                    name: 'list_skills',
+                    description: 'List all skills available to the current agent. Returns lean metadata (name + description) for each skill. ' +
+                        'Use get_skill to load the full instructions for a specific skill when needed.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+                {
+                    name: 'get_skill',
+                    description: 'Load the full instruction content for a specific skill by name. ' +
+                        "Call this when a task matches a skill's description to get detailed instructions before proceeding. " +
+                        'Also returns a list of available resources (scripts, references, assets).',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            skill_name: {
+                                type: 'string',
+                                description: 'The name of the skill to load (e.g. "deploy-app")',
+                            },
+                        },
+                        required: ['skill_name'],
+                    },
+                },
+                {
+                    name: 'get_skill_resource',
+                    description: 'Get a specific resource file attached to a skill. ' +
+                        'Resources can be scripts, reference documents, or assets that supplement the skill instructions.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            skill_name: {
+                                type: 'string',
+                                description: 'The name of the skill',
+                            },
+                            resource_name: {
+                                type: 'string',
+                                description: 'The name of the resource file',
+                            },
+                        },
+                        required: ['skill_name', 'resource_name'],
+                    },
+                },
             ],
         }));
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -1183,7 +1293,7 @@ class WolfpackMCPServer {
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
-                        let text = JSON.stringify(result.items, null, 2);
+                        let text = JSON.stringify(stripUuids(result.items), null, 2);
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use filters or limit/offset for pagination.\n\n${text}`;
                         }
@@ -1195,7 +1305,7 @@ class WolfpackMCPServer {
                         const parsed = GetWorkItemSchema.parse(args);
                         const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.project_slug || this.client.getProjectSlug() || undefined);
                         if (workItem) {
-                            let text = JSON.stringify(workItem, null, 2);
+                            let text = JSON.stringify(stripUuids(workItem), null, 2);
                             // Add hint if no plan detected in description
                             if (!hasPlan(workItem.description)) {
                                 text =
@@ -1218,7 +1328,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated description on: ${workItem.title}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Updated description on: ${workItem.title}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1235,7 +1345,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated status of "${workItem.title}" to ${parsed.status}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Updated status of "${workItem.title}" to ${parsed.status}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1257,7 +1367,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated "${workItem.title}" - now ${assigneeText}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Updated "${workItem.title}" - now ${assigneeText}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1274,7 +1384,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated title to "${workItem.title}"\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Updated title to "${workItem.title}"\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1294,7 +1404,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated "${workItem.title}" - ${initiativeText}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Updated "${workItem.title}" - ${initiativeText}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1313,7 +1423,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Pulled "${workItem.title}" from backlog to board (status: new)\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Pulled "${workItem.title}" from backlog to board (status: new)\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1330,7 +1440,7 @@ class WolfpackMCPServer {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Submitted form values for "${workItem.title}"\n\n${JSON.stringify(workItem, null, 2)}`,
+                                        text: `Submitted form values for "${workItem.title}"\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1349,7 +1459,7 @@ class WolfpackMCPServer {
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
-                        let text = JSON.stringify(result.items, null, 2);
+                        let text = JSON.stringify(stripUuids(result.items), null, 2);
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use stage filter or limit/offset for pagination.\n\n${text}`;
                         }
@@ -1362,7 +1472,7 @@ class WolfpackMCPServer {
                         const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.project_slug);
                         if (radarItem) {
                             return {
-                                content: [{ type: 'text', text: JSON.stringify(radarItem, null, 2) }],
+                                content: [{ type: 'text', text: JSON.stringify(stripUuids(radarItem), null, 2) }],
                             };
                         }
                         return {
@@ -1386,7 +1496,7 @@ class WolfpackMCPServer {
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
-                        let text = JSON.stringify(result.items, null, 2);
+                        let text = JSON.stringify(stripUuids(result.items), null, 2);
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use filters or limit/offset for pagination.\n\n${text}`;
                         }
@@ -1399,7 +1509,7 @@ class WolfpackMCPServer {
                         const issue = await this.client.getIssue(parsed.issue_id, parsed.project_slug);
                         if (issue) {
                             return {
-                                content: [{ type: 'text', text: JSON.stringify(issue, null, 2) }],
+                                content: [{ type: 'text', text: JSON.stringify(stripUuids(issue), null, 2) }],
                             };
                         }
                         return {
@@ -1424,7 +1534,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Created work item #${workItem.refId}: ${workItem.title}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                    text: `Created work item #${workItem.refId}: ${workItem.title}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                 },
                             ],
                         };
@@ -1449,7 +1559,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Created issue #${issue.refId}: ${issue.title}\n\n${JSON.stringify(issue, null, 2)}`,
+                                    text: `Created issue #${issue.refId}: ${issue.title}\n\n${JSON.stringify(stripUuids(issue), null, 2)}`,
                                 },
                             ],
                         };
@@ -1468,7 +1578,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Updated issue #${issue.refId}: ${issue.title}\n\n${JSON.stringify(issue, null, 2)}`,
+                                    text: `Updated issue #${issue.refId}: ${issue.title}\n\n${JSON.stringify(stripUuids(issue), null, 2)}`,
                                 },
                             ],
                         };
@@ -1484,7 +1594,7 @@ class WolfpackMCPServer {
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
-                        let text = JSON.stringify(result.items, null, 2);
+                        let text = JSON.stringify(stripUuids(result.items), null, 2);
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} pages. Use limit/offset for pagination.\n\n${text}`;
                         }
@@ -1497,7 +1607,7 @@ class WolfpackMCPServer {
                         const page = await this.client.getWikiPage(parsed.page_id);
                         if (page) {
                             return {
-                                content: [{ type: 'text', text: JSON.stringify(page, null, 2) }],
+                                content: [{ type: 'text', text: JSON.stringify(stripUuids(page), null, 2) }],
                             };
                         }
                         return {
@@ -1516,7 +1626,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Created wiki page: ${page.title}\n\n${JSON.stringify(page, null, 2)}`,
+                                    text: `Created wiki page: ${page.title}\n\n${JSON.stringify(stripUuids(page), null, 2)}`,
                                 },
                             ],
                         };
@@ -1531,7 +1641,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Updated wiki page: ${page.title}\n\n${JSON.stringify(page, null, 2)}`,
+                                    text: `Updated wiki page: ${page.title}\n\n${JSON.stringify(stripUuids(page), null, 2)}`,
                                 },
                             ],
                         };
@@ -1547,7 +1657,7 @@ class WolfpackMCPServer {
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
-                        let text = JSON.stringify(result.items, null, 2);
+                        let text = JSON.stringify(stripUuids(result.items), null, 2);
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} entries. Use limit/offset for pagination.\n\n${text}`;
                         }
@@ -1560,7 +1670,7 @@ class WolfpackMCPServer {
                         const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.project_slug);
                         if (entry) {
                             return {
-                                content: [{ type: 'text', text: JSON.stringify(entry, null, 2) }],
+                                content: [{ type: 'text', text: JSON.stringify(stripUuids(entry), null, 2) }],
                             };
                         }
                         return {
@@ -1572,14 +1682,13 @@ class WolfpackMCPServer {
                         const entry = await this.client.createJournalEntry({
                             title: parsed.title,
                             content: parsed.content,
-                            date: parsed.date,
                             teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
                         return {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Created journal entry #${entry.refId}: ${entry.title}\n\n${JSON.stringify(entry, null, 2)}`,
+                                    text: `Created journal entry #${entry.refId}: ${entry.title}\n\n${JSON.stringify(stripUuids(entry), null, 2)}`,
                                 },
                             ],
                         };
@@ -1594,7 +1703,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Updated journal entry #${entry.refId}: ${entry.title}\n\n${JSON.stringify(entry, null, 2)}`,
+                                    text: `Updated journal entry #${entry.refId}: ${entry.title}\n\n${JSON.stringify(stripUuids(entry), null, 2)}`,
                                 },
                             ],
                         };
@@ -1604,14 +1713,14 @@ class WolfpackMCPServer {
                         const parsed = ListWorkItemCommentsSchema.parse(args);
                         const comments = await this.client.listWorkItemComments(parsed.work_item_id);
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(comments, null, 2) }],
+                            content: [{ type: 'text', text: JSON.stringify(stripUuids(comments), null, 2) }],
                         };
                     }
                     case 'list_issue_comments': {
                         const parsed = ListIssueCommentsSchema.parse(args);
                         const comments = await this.client.listIssueComments(parsed.issue_id);
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(comments, null, 2) }],
+                            content: [{ type: 'text', text: JSON.stringify(stripUuids(comments), null, 2) }],
                         };
                     }
                     case 'create_work_item_comment': {
@@ -1623,7 +1732,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Added comment to work item\n\n${JSON.stringify(comment, null, 2)}`,
+                                    text: `Added comment to work item\n\n${JSON.stringify(stripUuids(comment), null, 2)}`,
                                 },
                             ],
                         };
@@ -1637,7 +1746,7 @@ class WolfpackMCPServer {
                             content: [
                                 {
                                     type: 'text',
-                                    text: `Added comment to issue\n\n${JSON.stringify(comment, null, 2)}`,
+                                    text: `Added comment to issue\n\n${JSON.stringify(stripUuids(comment), null, 2)}`,
                                 },
                             ],
                         };
@@ -1699,6 +1808,47 @@ class WolfpackMCPServer {
                             ],
                         };
                     }
+                    // Skill handlers
+                    case 'list_skills': {
+                        const skills = await this.client.listSkills();
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(skills, null, 2) }],
+                        };
+                    }
+                    case 'get_skill': {
+                        const parsed = GetSkillSchema.parse(args);
+                        const skill = await this.client.getSkill(parsed.skill_name);
+                        if (skill) {
+                            return {
+                                content: [{ type: 'text', text: JSON.stringify(skill, null, 2) }],
+                            };
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Skill '${parsed.skill_name}' not found. Use list_skills to see available skills.`,
+                                },
+                            ],
+                        };
+                    }
+                    case 'get_skill_resource': {
+                        const parsed = GetSkillResourceSchema.parse(args);
+                        const resource = await this.client.getSkillResource(parsed.skill_name, parsed.resource_name);
+                        if (resource) {
+                            return {
+                                content: [{ type: 'text', text: JSON.stringify(resource, null, 2) }],
+                            };
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Resource '${parsed.resource_name}' not found in skill '${parsed.skill_name}'.`,
+                                },
+                            ],
+                        };
+                    }
                     default:
                         throw new Error(`Unknown tool: ${name}`);
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.38",
+  "version": "1.0.39",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",