cp-toolkit 2.2.17 → 3.0.1

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "cp-toolkit",
-  "version": "2.2.17",
-  "description": "Copilot Toolkit - AI Agent framework for GitHub Copilot, Claude, Gemini CLI, and other AI assistants",
+  "version": "3.0.1",
+  "description": "Copilot Toolkit - Native AI Agents & Skills for GitHub Copilot (v2026)",
   "keywords": [
     "ai-agents",
     "github-copilot",
     "copilot",
     "gemini-cli",
-    "claude",
+    "agentic-workflow",
+    "mcp-server",
     "mcp",
     "model-context-protocol",
     "agent-toolkit"

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');

package/templates/AGENTS.md

@@ -1,6 +1,7 @@
 # Available Agents
 
-This project is equipped with specialized AI agents to assist with development. Invoke them using `@workspace` in Copilot Chat or by their specific names.
+This project is equipped with specialized AI Agent Personas to assist with development. 
+To activate an agent, simply mention their name (e.g., **@Orchestrator**) in your Copilot Chat prompt. The System Prompt will load their specific rules and capabilities.
 
 ## Core Agents
 

package/templates/ARCHITECTURE.md

@@ -1,4 +1,4 @@
-# Antigravity Kit Architecture
+# Copilot Kit Architecture
 
 > Comprehensive AI Agent Capability Expansion Toolkit
 > 
@@ -8,7 +8,7 @@
 
 ## 📋 Overview
 
-Antigravity Kit is a modular system consisting of:
+Copilot Kit is a modular system consisting of:
 
 - **20 Specialist Agents** - Role-based AI personas
 - **36 Skills** - Domain-specific knowledge modules (7 core + 29 optional)
@@ -50,7 +50,7 @@ applyTo: "**/*.ext"    # Glob pattern for Copilot context
 ---
 ```
 
-### RULES (`/rules/GEMINI.md`)
+### RULES (`/rules/AI_RULES.md`)
 ```yaml
 ---
 trigger: always_on     # Activation trigger
@@ -62,14 +62,14 @@ trigger: always_on     # Activation trigger
 ## 🏗️ Directory Structure
 
 ```plaintext
-.agent/
+.github/
 ├── ARCHITECTURE.md          # This file
 ├── agents/                  # 20 Specialist Agents
 ├── skills/
 │   ├── core/                # 7 Core Skills (always loaded)
 │   └── optional/            # 29 Optional Skills (on demand)
-├── workflows/               # 11 Slash Commands
-├── rules/                   # Global Rules (GEMINI.md)
+├── copilot-workflows/       # 11 Slash Commands
+├── rules/                   # Global Rules (AI_RULES.md)
 └── scripts/
     ├── mcp-server.js        # MCP Server for GitHub Copilot
     ├── checklist.py         # Quick validation
@@ -358,7 +358,7 @@ For details, see [scripts/README.md](scripts/README.md)
 | AI Assistant | Integration Method | Status |
 | ------------ | ------------------ | ------ |
 | **GitHub Copilot** | AGENTS.md + .github/copilot-instructions.md + MCP | ✅ Full |
-| **Gemini CLI** | .agent/rules/GEMINI.md | ✅ Full |
+| **Copilot CLI** | .github/rules/AI_RULES.md | ✅ Full |
 | **Claude** | AGENTS.md + MCP | ✅ Full |
 | **Cursor** | AGENTS.md | ✅ Full |
 | **OpenAI Codex** | AGENTS.md | ✅ Full |
@@ -373,8 +373,8 @@ The toolkit includes a custom MCP server that exposes:
 | **Tools** | `list_skills`, `load_skill` | Skill discovery and loading |
 | **Tools** | `list_workflows`, `execute_workflow` | Workflow execution |
 | **Tools** | `route_request` | Automatic agent routing |
-| **Resources** | `antigravity://architecture` | This documentation |
-| **Resources** | `antigravity://rules` | Base rules (GEMINI.md) |
+| **Resources** | `copilot://architecture` | This documentation |
+| **Resources** | `copilot://rules` | Base rules (AI_RULES.md) |
 | **Prompts** | `/{workflow}` | Slash commands as prompts |
 
 ### Configuration