workspace-architect 1.5.44 → 1.6.0

package/README.md

@@ -22,6 +22,8 @@ No installation required! Use directly with `npx`:
 
 ```bash
 npx workspace-architect list
+# or use the shorter alias
+npx wsa list
 ```
 
 Or install globally if you prefer:
@@ -36,18 +38,24 @@ List all available assets:
 
 ```bash
 npx workspace-architect list
+# or use the shorter alias
+npx wsa list
 ```
 
 Download a collection for web development:
 
 ```bash
 npx workspace-architect download collections:web-frontend-development
+# or
+npx wsa download collections:web-frontend-development
 ```
 
 Download a specific agent:
 
 ```bash
 npx workspace-architect download agents:azure-architect
+# or
+npx wsa download agents:azure-architect
 ```
 
 ## Usage
@@ -59,12 +67,14 @@ View all available assets or filter by type:
 ```bash
 # List all assets
 npx workspace-architect list
+# or
+npx wsa list
 
 # List specific types
 npx workspace-architect list instructions
-npx workspace-architect list agents
-npx workspace-architect list prompts
-npx workspace-architect list collections
+npx wsa list agents
+npx wsa list prompts
+npx wsa list collections
 ```
 
 ### Downloading Assets
@@ -73,19 +83,21 @@ Download assets to your project (default location: `.github/<type>/`):
 
 ```bash
 npx workspace-architect download <type>:<name>
+# or
+npx wsa download <type>:<name>
 ```
 
 **Examples:**
 
 ```bash
 # Download an instruction
-npx workspace-architect download instructions:reactjs
+npx wsa download instructions:reactjs
 
 # Download an agent
-npx workspace-architect download agents:planner
+npx wsa download agents:planner
 
 # Download a complete collection
-npx workspace-architect download collections:devops-essentials
+npx wsa download collections:devops-essentials
 ```
 
 ### CLI Options
@@ -96,15 +108,38 @@ npx workspace-architect download collections:devops-essentials
 
 ## Asset Types
 
-Workspace Architect provides four types of assets:
+Workspace Architect provides five types of assets:
 
 | Type | Description | Location |
 |------|-------------|----------|
 | **Instructions** | System-level guidelines for Copilot context | `.github/copilot-instructions.md` |
 | **Prompts** | Reusable templates for specific tasks | `.github/prompts/` |
 | **Agents** | Specialized personas defining Copilot behavior | `.github/agents/` |
+| **Skills** | Claude Skills with templates, scripts, and resources | `.github/skills/` |
 | **Collections** | Bundled assets for specific domains or workflows | Multiple locations |
 
+### What are Skills?
+
+**Skills** are an emerging standard for packaging AI agent capabilities. Compatible with Claude, GitHub Copilot, and other AI platforms, Skills are folder-based assets containing:
+
+- **SKILL.md**: Main instructions with metadata
+- **Templates**: Document or code templates
+- **Scripts**: Automation scripts (downloaded but not executed)
+- **Resources**: Reference materials and examples
+
+Skills follow the [open Agent Skills specification](https://agentskills.io/) and work across multiple AI platforms.
+
+**Example:**
+```bash
+# Download a Skill
+npx workspace-architect download skills:example-planner
+
+# List all Skills
+npx workspace-architect list skills
+```
+
+For more information, see [Skills User Guide](docs/skills-guide.md) and [Skills vs Agents](docs/skills-vs-agents.md).
+
 ## Roadmap
 
 See [ROADMAP.md](ROADMAP.md) for our development timeline, upcoming features, and current capabilities.
@@ -182,6 +217,7 @@ npm run start:registry
 # Terminal 2: Publish and test
 npm run publish:local
 npx --registry http://localhost:4873 workspace-architect list
+npx --registry http://localhost:4873 wsa list
 ```
 
 ## Project Structure

package/assets-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.0.0",
-  "generatedAt": "2025-12-16T23:07:51.294Z",
+  "version": "1.1.0",
+  "generatedAt": "2026-01-08T01:36:03.988Z",
   "assets": {
     "agents:4.1-Beast": {
       "path": "assets/agents/4.1-Beast.agent.md",
@@ -770,6 +770,12 @@
       "title": "a11y",
       "type": "instructions"
     },
+    "instructions:agents": {
+      "path": "assets/instructions/agents.instructions.md",
+      "description": "Guidelines for creating custom agent files for GitHub Copilot",
+      "title": "agents",
+      "type": "instructions"
+    },
     "instructions:ai-prompt-engineering-safety-best-practices": {
       "path": "assets/instructions/ai-prompt-engineering-safety-best-practices.instructions.md",
       "description": "Comprehensive best practices for AI prompt engineering, safety frameworks, bias mitigation, and responsible AI usage for Copilot and LLMs.",
@@ -2687,6 +2693,15 @@
         "prompts:suggest-awesome-github-copilot-prompts"
       ]
     },
+    "collections:claude-skills-starter": {
+      "path": "assets/collections/claude-skills-starter.json",
+      "description": "Essential Claude Skills for software development, planning, and automation workflows.",
+      "title": "Claude Skills Starter Pack",
+      "type": "collections",
+      "items": [
+        "skills:example-planner"
+      ]
+    },
     "collections:cpp-development": {
       "path": "assets/collections/cpp-development.json",
       "description": "C++ programming language resources.",
@@ -3891,6 +3906,21 @@
         "instructions:java-mcp-server",
         "instructions:typescript-5-es2022"
       ]
+    },
+    "skills:example-planner": {
+      "path": "assets/skills/example-planner",
+      "description": "Create detailed implementation plans for software features and refactoring tasks. Use this skill when planning new features, architectural changes, or major refactoring efforts.",
+      "title": "example-planner",
+      "type": "skills",
+      "files": [
+        "SKILL.md"
+      ],
+      "metadata": {
+        "version": "1.0.0",
+        "maintainer": "workspace-architect",
+        "category": "planning",
+        "license": "MIT"
+      }
     }
   }
 }

package/bin/cli.js

@@ -17,19 +17,19 @@ const MANIFEST_PATH = path.join(ROOT_DIR, 'assets-manifest.json');
 const IS_LOCAL = await fs.pathExists(ASSETS_DIR);
 
 program
-  .name('github-copilot-packed')
-  .description('CLI to download GitHub Copilot instructions, prompts, and chat modes')
+  .name('workspace-architect')
+  .description('CLI to download GitHub Copilot instructions, prompts, and agents (alias: wsa)')
   .version('1.0.0');
 
 program
   .command('list [type]')
-  .description('List available assets (instructions, prompts, agents, collections)')
+  .description('List available assets (instructions, prompts, agents, skills, collections)')
   .action(async (type) => {
     try {
       if (type) {
         await listAssets(type);
       } else {
-        const types = ['instructions', 'prompts', 'agents', 'collections'];
+        const types = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
         for (const t of types) {
           await listAssets(t);
         }
@@ -83,13 +83,22 @@ async function listAssets(type) {
     console.log(chalk.blue.bold(`\nAvailable ${type}:`));
     for (const file of files) {
       const filePath = path.join(dirPath, file);
+      const stat = await fs.stat(filePath);
       let description = '';
 
       try {
-        if (type === 'collections') {
+        if (type === 'skills' && stat.isDirectory()) {
+          // For Skills, read SKILL.md from directory
+          const skillMdPath = path.join(filePath, 'SKILL.md');
+          if (await fs.pathExists(skillMdPath)) {
+            const content = await fs.readFile(skillMdPath, 'utf8');
+            const parsed = matter(content);
+            description = parsed.data.description || '';
+          }
+        } else if (type === 'collections') {
           const content = await fs.readJson(filePath);
           description = content.description || '';
-        } else {
+        } else if (!stat.isDirectory()) {
           const content = await fs.readFile(filePath, 'utf8');
           const parsed = matter(content);
           description = parsed.data.description || '';
@@ -98,7 +107,7 @@ async function listAssets(type) {
         // Ignore errors reading metadata
       }
 
-      const name = path.parse(file).name;
+      const name = type === 'skills' && stat.isDirectory() ? file : path.parse(file).name;
       console.log(`  - ${name}${description ? ` - ${description}` : ''}`);
     }
   } else {
@@ -118,7 +127,8 @@ async function listAssets(type) {
 
     console.log(chalk.blue.bold(`\nAvailable ${type}:`));
     for (const asset of assets) {
-      console.log(`  - ${asset.id}${asset.description ? ` - ${asset.description}` : ''}`);
+      const versionInfo = asset.metadata?.version ? ` (v${asset.metadata.version})` : '';
+      console.log(`  - ${asset.id}${versionInfo}${asset.description ? ` - ${asset.description}` : ''}`);
     }
   }
 }
@@ -130,7 +140,7 @@ async function downloadAsset(id, options) {
     throw new Error('Invalid ID format. Use type:name (e.g., instructions:basic-setup)');
   }
 
-  const validTypes = ['instructions', 'prompts', 'agents', 'collections'];
+  const validTypes = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
   if (!validTypes.includes(type)) {
     throw new Error(`Invalid type: ${type}. Valid types are: ${validTypes.join(', ')}`);
   }
@@ -173,6 +183,12 @@ async function downloadAsset(id, options) {
     return;
   }
 
+  // Handle Skills (multi-file folder-based assets)
+  if (type === 'skills') {
+    await downloadSkill(name, options);
+    return;
+  }
+
   // Handle Single Asset
   let content = '';
   let fileName = '';
@@ -263,4 +279,117 @@ async function downloadAsset(id, options) {
   console.log(chalk.green(`Successfully downloaded ${fileName} to ${destDir}`));
 }
 
+async function downloadSkill(name, options) {
+  const skillName = name;
+  let skillFiles = [];
+  let skillPath = '';
+
+  if (IS_LOCAL) {
+    // Local mode: copy from assets/skills
+    skillPath = path.join(ASSETS_DIR, 'skills', skillName);
+    
+    if (!await fs.pathExists(skillPath)) {
+      throw new Error(`Skill not found: skills/${skillName}`);
+    }
+    
+    // Get all files in the skill directory
+    const getAllFiles = async (dir, baseDir = dir) => {
+      const files = [];
+      const entries = await fs.readdir(dir, { withFileTypes: true });
+      
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          const subFiles = await getAllFiles(fullPath, baseDir);
+          files.push(...subFiles);
+        } else {
+          const relativePath = path.relative(baseDir, fullPath);
+          files.push({ relative: relativePath, full: fullPath });
+        }
+      }
+      return files;
+    };
+    
+    skillFiles = await getAllFiles(skillPath);
+  } else {
+    // Production mode: fetch from manifest and download from GitHub
+    const manifest = await getManifest();
+    const key = `skills:${skillName}`;
+    const asset = manifest.assets[key];
+    
+    if (!asset) {
+      throw new Error(`Skill not found: ${key}`);
+    }
+    
+    skillPath = asset.path;
+    skillFiles = asset.files.map(file => ({
+      relative: file,
+      url: `https://raw.githubusercontent.com/archubbuck/workspace-architect/main/${asset.path}/${file}`
+    }));
+  }
+
+  // Determine destination
+  let destDir;
+  if (options.output) {
+    destDir = path.resolve(process.cwd(), options.output);
+  } else {
+    destDir = path.join(process.cwd(), '.github', 'skills', skillName);
+  }
+
+  if (options.dryRun) {
+    console.log(chalk.cyan(`[Dry Run] Would create skill directory at ${destDir}`));
+    for (const file of skillFiles) {
+      console.log(chalk.cyan(`  Would copy: ${file.relative}`));
+    }
+    return;
+  }
+
+  // Check if skill already exists
+  if (await fs.pathExists(destDir) && !options.force) {
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'overwrite',
+        message: `Skill ${skillName} already exists in ${destDir}. Overwrite?`,
+        default: false
+      }
+    ]);
+
+    if (!overwrite) {
+      console.log(chalk.yellow('Operation cancelled.'));
+      return;
+    }
+  }
+
+  console.log(chalk.blue(`Downloading skill: ${skillName}`));
+  
+  // Create skill directory
+  await fs.ensureDir(destDir);
+
+  // Download/copy all files
+  for (const file of skillFiles) {
+    const destPath = path.join(destDir, file.relative);
+    const destFileDir = path.dirname(destPath);
+    await fs.ensureDir(destFileDir);
+
+    if (IS_LOCAL) {
+      // Copy from local assets
+      await fs.copyFile(file.full, destPath);
+    } else {
+      // Download from GitHub
+      const response = await fetch(file.url);
+      if (!response.ok) {
+        console.warn(chalk.yellow(`Warning: Failed to download ${file.relative}`));
+        continue;
+      }
+      const content = await response.text();
+      await fs.writeFile(destPath, content);
+    }
+    
+    console.log(chalk.dim(`  Downloaded: ${file.relative}`));
+  }
+
+  console.log(chalk.green(`Successfully downloaded skill ${skillName} to ${destDir} (${skillFiles.length} files)`));
+}
+
 program.parse();

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "workspace-architect",
-  "version": "1.5.44",
+  "version": "1.6.0",
   "description": "A comprehensive library of specialized AI agents and personas for GitHub Copilot, ranging from architectural planning and specific tech stacks to advanced cognitive reasoning models.",
   "bin": {
-    "workspace-architect": "./bin/cli.js"
+    "workspace-architect": "./bin/cli.js",
+    "wsa": "./bin/cli.js"
   },
   "scripts": {
     "start:registry": "verdaccio --config verdaccio/config.yaml",
@@ -12,6 +13,8 @@
     "generate-manifest": "node scripts/generate-manifest.js",
     "prepublishOnly": "npm run generate-manifest",
     "fetch-upstream": "node scripts/fetch-upstream-assets.js",
+    "sync-skills": "node scripts/sync-anthropic-skills.js",
+    "validate-skills": "node scripts/validate-skills.js",
     "release": "release-it",
     "publish:local": "npm run release && npm publish --registry http://localhost:4873"
   },