cp-toolkit 2.2.16 → 3.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cp-toolkit",
-  "version": "2.2.16",
-  "description": "Copilot Toolkit - AI Agent framework for GitHub Copilot, Claude, Gemini CLI, and other AI assistants",
+  "version": "3.0.0",
+  "description": "Copilot Toolkit - Native AI Agents & Skills for GitHub Copilot (v2026)",
   "keywords": [
     "ai-agents",
     "github-copilot",

package/src/commands/add.js

@@ -13,8 +13,11 @@ const AGENT_TEMPLATES = {
   specialist: (name, description, triggers) => `---
 name: ${name}
 description: ${description}
-version: 1.0
-skills: clean-code
+model: gpt-4o
+capabilities:
+  - clean-code
+handoffs:
+  - project-planner
 ---
 
 # ${name}
@@ -41,8 +44,12 @@ ${triggers.map(t => `- ${t} related tasks`).join('\n')}
   reviewer: (name, description, triggers) => `---
 name: ${name}
 description: ${description}
-version: 1.0
-skills: clean-code, qa-automation-engineer
+model: gpt-4o
+capabilities:
+  - clean-code
+  - qa-automation-engineer
+handoffs:
+  - project-planner
 ---
 
 # ${name}
@@ -78,11 +85,31 @@ skills: clean-code, qa-automation-engineer
 `
 };
 
+const SKILL_TEMPLATE = (name, description) => `---
+name: ${name}
+description: ${description}
+version: 1.0.0
+---
+
+# Skill: ${name}
+
+> ${description}
+
+## Context & Rules
+- [Rule 1]
+- [Rule 2]
+
+## Code Snippets
+\`\`\`javascript
+// Example code for this skill
+\`\`\`
+`;
+
 export async function addCommand(type, name, options) {
   const targetDir = process.cwd();
 
   // Validate type
-  const validTypes = ['agent', 'instruction'];
+  const validTypes = ['agent', 'instruction', 'skill'];
   if (!validTypes.includes(type)) {
     console.log(chalk.red(`❌ Unknown type: ${type}`));
     console.log(chalk.dim(`   Valid types: ${validTypes.join(', ')}`));
@@ -103,6 +130,9 @@ export async function addCommand(type, name, options) {
     case 'agent':
       await addAgent(githubDir, name, options);
       break;
+    case 'skill':
+      await addSkill(githubDir, name, options);
+      break;
     case 'instruction':
       await addInstruction(githubDir, name, options);
       break;
@@ -110,7 +140,7 @@ export async function addCommand(type, name, options) {
 }
 
 async function addAgent(githubDir, name, options) {
-  const agentFile = path.join(githubDir, 'agents', `${name}.md`);
+  const agentFile = path.join(githubDir, 'agents', `${name}.agent.md`);
 
   if (fs.existsSync(agentFile)) {
     console.log(chalk.yellow(`⚠️  Agent "${name}" already exists.`));
@@ -152,10 +182,41 @@ async function addAgent(githubDir, name, options) {
   await fs.ensureDir(path.dirname(agentFile));
   await fs.writeFile(agentFile, content);
 
-  console.log(chalk.green(`✅ Created agent: .github/agents/${name}.md`));
+  console.log(chalk.green(`✅ Created agent: .github/agents/${name}.agent.md`));
   console.log(chalk.dim(`   Invoke with @${name} in Copilot Chat`));
 }
 
+async function addSkill(githubDir, name, options) {
+  const skillFile = path.join(githubDir, 'skills', name, 'SKILL.md');
+
+  if (fs.existsSync(skillFile)) {
+    console.log(chalk.yellow(`⚠️  Skill "${name}" already exists.`));
+    return;
+  }
+
+  const response = await prompts([
+    {
+      type: 'text',
+      name: 'description',
+      message: 'Description (used for semantic loading):',
+      initial: `${name} helper`
+    }
+  ]);
+
+  if (!response.description) {
+    console.log(chalk.yellow('Aborted.'));
+    return;
+  }
+
+  const content = SKILL_TEMPLATE(name, response.description);
+
+  await fs.ensureDir(path.dirname(skillFile));
+  await fs.writeFile(skillFile, content);
+
+  console.log(chalk.green(`✅ Created skill: .github/skills/${name}/SKILL.md`));
+  console.log(chalk.dim(`   This skill will be loaded when you ask about "${response.description}"`));
+}
+
 async function addInstruction(githubDir, name, options) {
   const instrFile = path.join(githubDir, 'instructions', `${name}.instructions.md`);
 

package/src/commands/doctor.js

@@ -30,10 +30,15 @@ const CHECKS = [
       const agentsDir = path.join(dir, '.github', 'agents');
       if (!await fs.pathExists(agentsDir)) return false;
       const files = await fs.readdir(agentsDir);
-      return files.some(f => f.endsWith('.md'));
+      return files.some(f => f.endsWith('.agent.md') || f.endsWith('.md'));
     },
     fix: 'Run: cp-kit add agent <name>'
   },
+  {
+    name: 'skills/ directory exists',
+    check: async (dir) => fs.pathExists(path.join(dir, '.github', 'skills')),
+    fix: 'Run: cp-kit init'
+  },
   {
     name: 'instructions/ directory exists',
     check: async (dir) => fs.pathExists(path.join(dir, '.github', 'instructions')),
@@ -77,22 +82,22 @@ const CHECKS = [
     fix: 'Add version and description frontmatter to instruction files'
   },
   {
-    name: 'Agents have complete frontmatter (name, description, skills)',
+    name: 'Agents have complete frontmatter (name, description, capabilities)',
     check: async (dir) => {
       const agentsDir = path.join(dir, '.github', 'agents');
       if (!await fs.pathExists(agentsDir)) return true;
       const files = await fs.readdir(agentsDir);
-      for (const file of files.filter(f => f.endsWith('.md'))) {
+      for (const file of files.filter(f => f.endsWith('.agent.md'))) {
         const content = await fs.readFile(path.join(agentsDir, file), 'utf-8');
         if (!content.startsWith('---')) return false;
         if (!content.includes('name:')) return false;
         if (!content.includes('description:')) return false;
-        if (!content.includes('skills:')) return false;
-        if (!content.includes('applyTo:')) return false;
+        // Capabilities is the new standard (was skills)
+        if (!content.includes('capabilities:') && !content.includes('tools:')) return false; 
       }
       return true;
     },
-    fix: 'Update agent files with full frontmatter (name, description, skills, applyTo)'
+    fix: 'Update agent files with full frontmatter (name, description, capabilities, model)'
   }
 ];
 

package/src/commands/init.js

@@ -103,11 +103,14 @@ export async function initCommand(directory, options) {
       'database-design',
       'testing-patterns',
       'deployment-procedures',
-      'architecture'
+      'architecture',
+      'brainstorming',
+      'clean-code',
+      'plan-writing'
     ];
 
     for (const skill of essentialSkills) {
-      const skillSourceDir = path.join(templatesDir, 'skills', 'optional', skill);
+      const skillSourceDir = path.join(templatesDir, 'skills', skill);
       if (fs.existsSync(skillSourceDir)) {
         const skillTargetDir = path.join(skillsTargetDir, skill);
         await fs.ensureDir(skillTargetDir);
@@ -127,10 +130,29 @@ export async function initCommand(directory, options) {
     const modelsTemplatePath = path.join(templatesDir, 'cp-kit-models.yaml');
     await fs.copy(modelsTemplatePath, modelsPath);
 
-    // 7. Setup .vscode/mcp.json
-    spinner.text = 'Configuring MCP Server...';
+    // 7. Setup .vscode/settings.json
+    spinner.text = 'Configuring VS Code settings...';
     const vscodeDir = path.join(targetDir, '.vscode');
     await fs.ensureDir(vscodeDir);
+    
+    const settingsPath = path.join(vscodeDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(await fs.readFile(settingsPath, 'utf8'));
+      } catch (e) {
+        // ignore error
+      }
+    }
+
+    settings['chat.agent.skills.enabled'] = true;
+    // Suggest other useful settings for 2026
+    settings['github.copilot.chat.welcomeMessage'] = "always";
+
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+
+    // 8. Setup .vscode/mcp.json
+    spinner.text = 'Configuring MCP Server...';
 
     const mcpConfig = {
       "mcpServers": {
@@ -152,14 +174,6 @@ export async function initCommand(directory, options) {
           ],
           "disabled": false,
           "autoApprove": []
-        },
-        "antigravity": {
-          "command": "node",
-          "args": [
-            "${workspaceFolder}/.github/scripts/mcp-server.js"
-          ],
-          "disabled": false,
-          "autoApprove": []
         }
       }
     };
@@ -169,7 +183,7 @@ export async function initCommand(directory, options) {
       JSON.stringify(mcpConfig, null, 2)
     );
 
-    // 8. Copy workflows to .github/workflows-copilot/ (optional reference)
+    // 9. Copy workflows to .github/workflows-copilot/ (optional reference)
     if (config.installEverything) {
       spinner.text = 'Copying workflows...';
       const workflowsSourceDir = path.join(templatesDir, 'workflows');