internaltool-mcp 1.6.41 → 1.6.42

package/index.js

@@ -463,6 +463,60 @@ Returns tasks with key, title, column, assignees, priority, taskType, and branch
     }
   )
 
+  // ── suggest_skill ─────────────────────────────────────────────────────────────
+  server.tool(
+    'suggest_skill',
+    `Propose a reusable skill, rule, prompt, subagent, or hook to the project's AgentKit — pending human approval.
+
+## When to call this
+
+Call this when you discover something during a coding session that would help future sessions in this codebase:
+
+- **skill**: A step-by-step methodology you used (e.g. "how to add a new API endpoint in this Express app", "how to run and interpret the test suite")
+- **rule**: A constraint that should always apply (e.g. "always validate with zod before touching the DB", "never modify migrations directly")
+- **prompt**: A prompt template that reliably produces good results for this project (e.g. "security sweep prompt", "PR review checklist")
+- **subagent**: A specialized agent persona (e.g. "database migration specialist with access to prisma tools only")
+- **hook**: A shell command that should run automatically (e.g. "check .internaltool-active-task before any Edit", "run lint after Write")
+
+## When NOT to call this
+
+- Do not suggest things that are obvious from the README or existing docs
+- Do not suggest generic skills that apply to any codebase (e.g. "how to write clean code")
+- Do not suggest more than 1-2 skills per session — be selective and high-signal
+
+## The human reviews and decides
+
+Your suggestion goes into a "Pending" queue visible in the project's AgentKit UI.
+The developer can edit the body, approve (which promotes it to active config), or reject.
+After approval, the skill/rule is injected at every future kickoff_task.`,
+    {
+      projectId:     z.string().describe("Project's MongoDB ObjectId"),
+      type:          z.enum(['skill', 'rule', 'prompt', 'subagent', 'hook']).describe('What kind of suggestion this is'),
+      name:          z.string().describe('Slug name — lowercase, hyphens, no spaces (e.g. "add-express-route", "require-zod-validation")'),
+      description:   z.string().describe('One-line description of what this does — shown in the AgentKit UI'),
+      body:          z.string().describe('Full markdown content — for skills: step-by-step instructions; for rules: constraint language; for hooks: shell command + explanation'),
+      rationale:     z.string().describe('Why this would help future sessions — what problem it solves, what mistake it prevents, or what pattern it captures'),
+      sourceTaskId:  z.string().optional().describe('Task ID this was discovered during (for traceability)'),
+      sourceTaskKey: z.string().optional().describe('Task key (e.g. PROJ-42) for display'),
+      // Hook-specific
+      hookTrigger:   z.string().optional().describe('For type=hook: when it fires (PreToolUse | PostToolUse | Stop)'),
+      hookMatcher:   z.string().optional().describe('For type=hook: tool name regex matcher (e.g. "Edit|Write")'),
+      hookCommand:   z.string().optional().describe('For type=hook: the shell command to execute'),
+    },
+    async ({ projectId, type, name, description, body, rationale, sourceTaskId, sourceTaskKey, hookTrigger, hookMatcher, hookCommand }) => {
+      try { assertProjectScope(projectId) } catch (e) { return errorText(e.message) }
+      return call(() => api.post(`/api/projects/${projectId}/skill-suggestions`, {
+        type, name, description, body, rationale,
+        sourceTaskId: sourceTaskId || null,
+        sourceTaskKey: sourceTaskKey || '',
+        suggestedBy: 'Claude Code',
+        hookTrigger: hookTrigger || '',
+        hookMatcher: hookMatcher || '',
+        hookCommand: hookCommand || '',
+      }))
+    }
+  )
+
   // ── plan_task_from_codebase ───────────────────────────────────────────────────
   server.tool(
     'plan_task_from_codebase',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "internaltool-mcp",
-  "version": "1.6.41",
+  "version": "1.6.42",
   "description": "MCP server for InternalTool — connect AI assistants (Claude Code, Cursor) to your project and task management platform",
   "type": "module",
   "main": "index.js",