tech-hub-skills 1.1.1 → 1.5.1

package/README.md

@@ -1,250 +1,184 @@
-# Tech Hub Skills - Complete Role Documentation
+# Tech Hub Skills
 
-This document provides detailed information about all available roles and their skills.
+110+ production-ready AI agent skills for **Claude Code** and **GitHub Copilot**. Enterprise-grade with security, governance, and compliance built-in.
 
-For installation instructions, see [../README.md](../README.md).
+## Quick Install
 
-## Quick Reference
-
-Use skills in Claude Code with `@` mentions:
+### For Claude Code
 
 ```bash
-# Start with the orchestrator (routes to all skills)
-@orchestrator "Build a customer churn prediction model"
-
-# Or invoke specific roles
-@ai-engineer "Create a RAG pipeline"
-@security-architect "Review this code for PII"
-@data-engineer "Design a lakehouse architecture"
+# npm/npx (Recommended)
+npx tech-hub-skills install
 
-# Enterprise mode (mandatory security + governance)
-@project-starter --enterprise "Build a customer data platform"
-```
-
-## Available Roles & Skills
-
-### Core Engineering (34 skills)
-| Role | Skills | Focus |
-|------|--------|-------|
-| **AI Engineer** | 8 | LLMs, RAG, Agents, Guardrails, Embeddings |
-| **Data Engineer** | 9 | Lakehouse, ETL/ELT, Streaming, Quality |
-| **ML Engineer** | 9 | MLOps, Training, Serving, Monitoring |
-| **Data Scientist** | 8 | EDA, Modeling, Analytics, Experimentation |
-
-### Architecture & Security Roles (15 skills)
-| Role | Skills | Focus |
-|------|--------|-------|
-| **Security Architect** | 7 | PII, Threat Modeling, IAM, Secrets |
-| **System Design** | 8 | Architecture, Scalability, HA/DR, APIs |
-
-### Platform & Operations Roles (45 skills)
-| Role | Skills | Focus |
-|------|--------|-------|
-| **Platform Engineer** | 6 | IDP, Self-Service, SLOs |
-| **Data Governance** | 6 | Catalog, Lineage, Quality, Compliance |
-| **DevOps** | 9 | CI/CD, Containers, IaC, GitOps |
-| **MLOps** | 9 | Experiments, Registry, Deployment |
-| **FinOps** | 8 | Cost Visibility, Optimization |
-| **Docker** | 5 | Containers, Security, Optimization |
-
-### Enterprise Governance Roles (10+ skills)
-| Role | Skills | FocRoles us |
-|------|--------|-------|
-| **Code Review** | 5 | PR Automation, Quality Gates, Analytics |
-| **Compliance** | Integrated | SOC 2, GDPR, HIPAA, Audit Trails |
-| **Dashboard** | Integrated | Security, Compliance, DORA Metrics |
-
-### Product & Design Roles (6 skills)
-| Role | Skills | Focus |
-|------|--------|-------|
-| **Product Designer** | 6 | Requirements, Research, UX, Brainstorming |
-
-### Cloud Platform Roles (12 skills)
-| Role | Skills | Focus |
-|------|--------|-------|
-| **Azure** | 12 | All Azure services |
-
-## Directory Structure
-
-```
-.claude/
-├── skills/                 # Role skill files (invoke with @role-name)
-│   ├── orchestrator.md     # Main orchestrator - routes to all skills
-│   ├── ai-engineer.md
-│   ├── data-engineer.md
-│   ├── security-architect.md
-│   ├── code-review.md
-│   ├── compliance-automation.md
-│   └── ...
-├── roles/                  # Detailed skill implementations
-│   ├── ai-engineer/
-│   │   └── skills/
-│   │       ├── 01-prompt-engineering/README.md
-│   │       ├── 02-rag-pipeline/README.md
-│   │       └── ...
-│   ├── security-architect/
-│   │   └── skills/
-│   │       ├── 01-pii-detection/README.md
-│   │       ├── 02-threat-modeling/README.md
-│   │       └── ...
-│   └── ...
-└── README.md               # This file
+# or Python
+pip install tech-hub-skills && tech-hub-skills install
 ```
 
-## Skill ID Reference
-
-| Role | Prefix | Skills |
-|------|--------|--------|
-| AI Engineer | `ai-` | ai-01 to ai-08 |
-| Data Engineer | `de-` | de-01 to de-09 |
-| ML Engineer | `ml-` | ml-01 to ml-09 |
-| Data Scientist | `ds-` | ds-01 to ds-08 |
-| Security Architect | `sa-` | sa-01 to sa-07 |
-| System Design | `sd-` | sd-01 to sd-08 |
-| Platform Engineer | `pe-` | pe-01 to pe-06 |
-| Data Governance | `dg-` | dg-01 to dg-06 |
-| DevOps | `do-` | do-01 to do-09 |
-| MLOps | `mo-` | mo-01 to mo-09 |
-| FinOps | `fo-` | fo-01 to fo-08 |
-| Azure | `az-` | az-01 to az-12 |
-| Code Review | `cr-` | cr-01 to cr-05 |
-| Product Designer | `pd-` | pd-01 to pd-06 |
-
-## Enterprise Mode
-
-For production applications, use Enterprise Mode to ensure security and governance:
+### For GitHub Copilot (VSCode)
 
 ```bash
-@project-starter --enterprise "Build a production API"
-```
-
-Enterprise Mode **automatically includes**:
-- Security Architect (sa-01 to sa-07)
-- Data Governance (dg-01 to dg-06)
-- Code Review (cr-01 to cr-05)
-- Compliance Automation
+# npm/npx
+npx tech-hub-skills install --copilot
 
-### Enterprise Workflow
-```
-Requirements → Security Assessment → Data Classification
-     ↓
-Architecture → Security Review → Governance Review
-     ↓
-Development → Code Review → Compliance Check
-     ↓
-Deployment → Security Scan → Production Approval
-     ↓
-Monitoring → Continuous Compliance
+# or Python
+pip install tech-hub-skills && tech-hub-skills install --copilot
 ```
 
-### Enterprise Quality Gates
-- No critical/high vulnerabilities
-- 80%+ code coverage
-- All compliance controls passing
-- Security architect sign-off
-- Data governance sign-off
+This creates `.github/copilot-instructions.md` with all expert skills.
+See [GITHUB_COPILOT.md](GITHUB_COPILOT.md) for usage guide.
 
-## Examples
+### Global Install (Claude Code only)
 
-### AI/ML Project
 ```bash
-@orchestrator "Build a customer churn prediction model with GDPR compliance"
+# Install globally for all projects
+npx tech-hub-skills install --global
 ```
-Auto-includes: sa-01 (PII), dg-01 (catalog), ml-01-05, mo-01-06
 
-### RAG Application
-```bash
-@ai-engineer ai-02 "Create a RAG pipeline for internal docs"
-```
+### Manual Installation
 
-### Security Review
 ```bash
-@security-architect "Audit this codebase for security vulnerabilities"
-```
+# Clone and copy .claude folder to your project
+git clone https://github.com/6ogo/Tech-Skills.git
+cp -r tech-hub-skills/.claude your-project/
+```
+
+## What's Included
+
+- **26 Role Skills**: AI Engineer, Data Engineer, Security Architect, DevOps, and more
+- **180+ Detailed Implementations**: Step-by-step guides for each skill
+- **Enterprise Mode**: Built-in security, governance, and compliance
+- **Cross-Platform**: Works on Windows, macOS, Linux
+
+## Available Roles
+
+| Role                   | Skills | Focus                                       |
+| ---------------------- | ------ | ------------------------------------------- |
+| **AI Engineer**        | 8      | LLMs, RAG, Agents, Guardrails, Embeddings   |
+| **Data Engineer**      | 9      | Lakehouse, ETL/ELT, Streaming, Quality      |
+| **ML Engineer**        | 9      | MLOps, Training, Serving, Monitoring        |
+| **Data Scientist**     | 8      | EDA, Modeling, Analytics, Experimentation   |
+| **Frontend Developer** | 7      | React/Vue/Angular, TypeScript, A11y         |
+| **Backend Developer**  | 7      | REST, GraphQL, Microservices, Caching       |
+| **Security Architect** | 7      | PII, Threat Modeling, IAM, Secrets          |
+| **System Design**      | 8      | Architecture, Scalability, HA/DR, APIs      |
+| **Network Engineer**   | 7      | Topology, VPN/VPC, Load Balancers, CDN      |
+| **Platform Engineer**  | 6      | IDP, Self-Service, SLOs                     |
+| **SRE**                | 7      | Incident Response, Chaos Engineering, SLOs  |
+| **Database Admin**     | 7      | Query Optimization, Replication, Migrations |
+| **Data Governance**    | 6      | Catalog, Lineage, Quality, Compliance       |
+| **DevOps**             | 9      | CI/CD, Containers, IaC, GitOps              |
+| **Docker**             | 5      | Dockerfile, Security, Optimization          |
+| **MLOps**              | 9      | Experiments, Registry, Deployment           |
+| **FinOps**             | 8      | Cost Visibility, Optimization               |
+| **Azure**              | 12     | All Azure services                          |
+| **AWS**                | 12     | EC2, Lambda, S3, RDS, VPC, EKS              |
+| **GCP**                | 12     | Compute, BigQuery, GKE, Pub/Sub             |
+| **Code Review**        | 5      | PR Automation, Quality Gates                |
+| **Compliance Officer** | 7      | SOC 2, GDPR, HIPAA, PCI-DSS                 |
+| **QA Engineer**        | 7      | Test Strategy, Automation, Performance      |
+| **Technical Writer**   | 6      | API Docs, ADRs, Runbooks                    |
+| **Product Designer**   | 6      | Requirements, Research, UX                  |
+
+See [.claude/README.md](.claude/README.md) for detailed role documentation.
+
+## Usage
+
+### Claude Code
+
+Use `@` mentions to invoke specific expert roles:
 
-### Enterprise Platform
 ```bash
-@project-starter --enterprise "Build a customer data platform"
+# Start with the orchestrator
+@orchestrator "Build a customer churn prediction model"
+
+# Or use specific roles
+@ai-engineer "Create a RAG pipeline"
+@security-architect "Review this code for PII"
+@data-engineer "Design a lakehouse architecture"
 ```
-Auto-includes: ALL security + governance + compliance skills
 
-## Integration Options
+### GitHub Copilot
 
-### Claude Code (Primary)
-Skills are designed for Claude Code's `@` mention system.
+Copilot automatically applies expert knowledge. Reference roles in comments:
 
-### CrewAI
 ```python
-from crewai import Agent, Task, Crew
+# Using AI Engineer approach for RAG pipeline
+def build_rag():
+    # Copilot suggests best practices
 
-orchestrator = Agent(
-    role="Tech Hub Orchestrator",
-    goal="Coordinate skills for optimal project execution",
-    backstory=open(".claude/skills/orchestrator.md").read()
-)
+# Apply Security Architect principles
+def process_data(user_input):
+    # Copilot adds input validation, PII scanning
 ```
 
-### LangGraph
-```python
-from langgraph.graph import StateGraph
+See [GITHUB_COPILOT.md](GITHUB_COPILOT.md) for complete guide.
+
+## Updating
 
-# Load skills as node definitions
-skills = load_skills(".claude/skills/")
+### Method 1 (Clone/ZIP)
+
+```bash
+# Pull latest changes
+cd path/to/tech-hub-skills
+git pull
+
+# Copy updated files
+cp -r .claude your-project/
 ```
 
-## Integration Options
+After installation, use skills with `@` mentions:
 
-### Claude Code (Primary)
-Skills are designed for Claude Code's `@` mention system.
+```bash
+# Start with the orchestrator (routes to all skills)
+@orchestrator "Build a customer churn prediction model"
 
-### CrewAI
-```python
-from crewai import Agent, Task, Crew
+# Or invoke specific roles
+@ai-engineer "Create a RAG pipeline"
+@security-architect "Review this code for PII"
+@data-engineer "Design a lakehouse architecture"
 
-orchestrator = Agent(
-    role="Tech Hub Orchestrator",
-    goal="Coordinate skills for optimal project execution",
-    backstory=open(".claude/skills/orchestrator.md").read()
-)
+# Enterprise mode (mandatory security + governance)
+@project-starter --enterprise "Build a customer data platform"
 ```
 
-### LangGraph
-```python
-from langgraph.graph import StateGraph
+## Examples
+
+**AI/ML Project**
 
-# Load skills as node definitions
-skills = load_skills(".claude/skills/")
+```bash
+@orchestrator "Build a customer churn prediction model with GDPR compliance"
 ```
 
-## Repository Structure
+**RAG Application**
 
+```bash
+@ai-engineer "Create a RAG pipeline for internal docs"
 ```
-.claude/
-├── skills/                 # Role skill files (invoke with @role-name)
-│   ├── orchestrator.md     # Main orchestrator - routes to all skills
-│   ├── ai-engineer.md
-│   ├── data-engineer.md
-│   ├── security-architect.md
-│   └── ...
-├── roles/                  # Detailed skill implementations
-│   ├── ai-engineer/
-│   │   └── skills/
-│   │       ├── 01-prompt-engineering/README.md
-│   │       ├── 02-rag-pipeline/README.md
-│   │       └── ...
-│   └── ...
-└── README.md               # This file
+
+**Security Review**
+
+```bash
+@security-architect "Audit this codebase for security vulnerabilities"
 ```
 
+**Enterprise Platform**
+
+```bash
+@project-starter --enterprise "Build a customer data platform"
+```
+
+## Documentation
+
+- **All Roles**: See [.claude/README.md](.claude/README.md) for complete role documentation
+- **Publishing**: See [PUBLISHING.md](PUBLISHING.md) for maintainer instructions
+
 ## Contributing
 
 1. Fork the repository
-2. Add skills to `roles/{role}/skills/{skill-id}/`
-3. Update `skills/{role}.md`
+2. Add skills to `.claude/roles/{role}/skills/{skill-id}/`
+3. Update `.claude/skills/{role}.md`
 4. Submit PR
 
-For publishing instructions (maintainers only), see [../PUBLISHING.md](../PUBLISHING.md).
-
 ## License
 
 MIT

package/package.json

@@ -1,46 +1,8 @@
 {
   "name": "tech-hub-skills",
-  "version": "1.1.1",
-  "description": "110+ production-ready AI agent skills for Claude Code and GitHub Copilot",
-  "main": "bin/cli.js",
-  "bin": {
-    "tech-hub-skills": "./bin/cli.js"
-  },
-  "scripts": {
-    "postinstall": "node bin/postinstall.js"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "github-copilot",
-    "copilot",
-    "ai-agents",
-    "skills",
-    "llm",
-    "ai-engineer",
-    "data-engineer",
-    "security",
-    "enterprise",
-    "vscode"
-  ],
-  "author": "6ogo",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/6ogo/Tech-Skills.git"
-  },
-  "files": [
-    "tech_hub_skills/skills/**/*.md",
-    "tech_hub_skills/roles/**/*.md",
-    "bin/**/*.js",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "homepage": "https://github.com/6ogo/Tech-Skills#readme",
-  "bugs": {
-    "url": "https://github.com/6ogo/Tech-Skills/issues"
+  "version": "1.5.1",
+  "description": "Collection of tech skills for Claude Code",
+  "dependencies": {
+    "tech-hub-skills": "^1.5.1"
   }
 }

package/bin/cli.js

@@ -1,241 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-const { installCopilotInstructions } = require('./copilot');
-
-const SKILLS_DIR = path.join(__dirname, '..');
-const VERSION = require('../package.json').version;
-
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-  magenta: '\x1b[35m'
-};
-
-function print(msg, color = 'reset') {
-  console.log(`${colors[color]}${msg}${colors.reset}`);
-}
-
-function printBanner() {
-  console.log(`
-${colors.cyan}╔═══════════════════════════════════════════════════════════╗
-║         TECH HUB SKILLS - AI Agent Skills for Claude       ║
-║                  110+ Production-Ready Skills               ║
-╚═══════════════════════════════════════════════════════════╝${colors.reset}
-  `);
-}
-
-function copyDir(src, dest) {
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    // Skip bin, node_modules, package.json
-    if (['bin', 'node_modules', 'package.json', 'package-lock.json'].includes(entry.name)) {
-      continue;
-    }
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function install(options = {}) {
-  const isGlobal = options.global;
-  const targetDir = isGlobal
-    ? path.join(require('os').homedir(), '.claude')
-    : path.join(process.cwd(), '.claude');
-
-  print(`\n📦 Installing Tech Hub Skills to: ${targetDir}`, 'cyan');
-
-  // Copy skills and roles
-  const skillsSrc = path.join(SKILLS_DIR, 'tech_hub_skills', 'skills');
-  const rolesSrc = path.join(SKILLS_DIR, 'tech_hub_skills', 'roles');
-  const skillsDest = path.join(targetDir, 'skills');
-  const rolesDest = path.join(targetDir, 'roles');
-
-  if (fs.existsSync(skillsSrc)) {
-    print('  Copying skills...', 'yellow');
-    copyDir(skillsSrc, skillsDest);
-  }
-
-  if (fs.existsSync(rolesSrc)) {
-    print('  Copying roles...', 'yellow');
-    copyDir(rolesSrc, rolesDest);
-  }
-
-  // Install GitHub Copilot instructions if requested (project-level only)
-  if (options.copilot && !isGlobal) {
-    print('\n🤖 Installing GitHub Copilot integration...', 'cyan');
-    installCopilotInstructions({ force: options.force });
-  } else if (options.copilot && isGlobal) {
-    print('\n⚠️  Copilot integration is only available for project-level installs', 'yellow');
-    print('    (Copilot instructions must be in project .github/ directory)', 'yellow');
-  }
-
-  // Count installed files
-  const skillCount = fs.existsSync(skillsDest)
-    ? fs.readdirSync(skillsDest).filter(f => f.endsWith('.md')).length
-    : 0;
-
-  print(`\n✓ Installation complete!`, 'green');
-  print(`  Location: ${targetDir}`, 'cyan');
-  print(`  Skills: ${skillCount} role files installed`, 'cyan');
-  print(`  Roles: 16+ specialized agents`, 'cyan');
-  if (options.copilot && !isGlobal) {
-    print(`  Copilot: .github/copilot-instructions.md`, 'cyan');
-  }
-
-  print(`\n${colors.bright}Next Steps:${colors.reset}`);
-  if (options.copilot && !isGlobal) {
-    print('  GitHub Copilot:');
-    print('  1. Open VSCode with GitHub Copilot enabled');
-    print('  2. Copilot will automatically use the instructions');
-    print('  3. Try: // Using AI Engineer approach for RAG pipeline');
-    print('');
-  }
-  print('  Claude Code:');
-  print('  1. Open Claude Code in your project');
-  print('  2. Use @orchestrator to start');
-  print('  3. Or invoke specific roles: @ai-engineer, @security-architect, etc.');
-
-  print(`\n${colors.bright}Example:${colors.reset}`);
-  if (options.copilot && !isGlobal) {
-    print('  Copilot: // Apply Security Architect best practices');
-  }
-  print('  Claude: @orchestrator "Build a customer churn prediction model"');
-}
-
-function init(options = {}) {
-  printBanner();
-
-  if (options.enterprise) {
-    print('\n🏢 ENTERPRISE MODE', 'magenta');
-    print('   Mandatory: Security Architect + Data Governance', 'yellow');
-    print('\n   Use in Claude Code:', 'cyan');
-    print('   @project-starter --enterprise "Your project description"');
-  } else {
-    print('\n📦 Standard Mode', 'cyan');
-    print('\n   Use in Claude Code:', 'cyan');
-    print('   @project-starter "Your project description"');
-  }
-}
-
-function list() {
-  printBanner();
-
-  const roles = [
-    { name: 'Orchestrator', skills: 'Routes all', focus: 'Project coordination' },
-    { name: 'AI Engineer', skills: '8', focus: 'LLMs, RAG, Agents' },
-    { name: 'Data Engineer', skills: '9', focus: 'Pipelines, Lakehouse' },
-    { name: 'ML Engineer', skills: '9', focus: 'Training, Serving, MLOps' },
-    { name: 'Data Scientist', skills: '8', focus: 'Analytics, Modeling' },
-    { name: 'Security Architect', skills: '7', focus: 'PII, IAM, Compliance' },
-    { name: 'System Design', skills: '8', focus: 'Architecture, Scalability' },
-    { name: 'Platform Engineer', skills: '6', focus: 'IDP, SLOs' },
-    { name: 'Data Governance', skills: '6', focus: 'Catalog, Lineage, Quality' },
-    { name: 'DevOps', skills: '9', focus: 'CI/CD, Containers, IaC' },
-    { name: 'MLOps', skills: '9', focus: 'Experiments, Registry' },
-    { name: 'FinOps', skills: '8', focus: 'Cost Optimization' },
-    { name: 'Azure', skills: '12', focus: 'Azure Services' },
-    { name: 'Code Review', skills: '5', focus: 'PR Automation, Quality Gates' },
-    { name: 'Product Designer', skills: '6', focus: 'Requirements, UX' },
-  ];
-
-  print('\nAvailable Roles:\n', 'bright');
-  console.log('  Role                 Skills   Focus');
-  console.log('  ────────────────────────────────────────────────');
-
-  for (const role of roles) {
-    const name = role.name.padEnd(20);
-    const skills = role.skills.toString().padEnd(8);
-    console.log(`  ${name} ${skills} ${role.focus}`);
-  }
-
-  print('\n  Total: 110+ skills across 16+ roles', 'cyan');
-}
-
-function showHelp() {
-  printBanner();
-  console.log(`
-${colors.bright}Usage:${colors.reset}
-  npx tech-hub-skills <command> [options]
-
-${colors.bright}Commands:${colors.reset}
-  install              Install skills to current project (Claude Code)
-  install --copilot    Install with GitHub Copilot integration
-  install --global     Install skills globally (~/.claude)
-  install --force      Force overwrite existing installation
-  init                 Initialize project with guided setup
-  init --enterprise    Enterprise mode with security + governance
-  list                 List all available roles and skills
-  help                 Show this help message
-
-${colors.bright}Options:${colors.reset}
-  --copilot, -c        Add GitHub Copilot instructions (.github/copilot-instructions.md)
-  --global, -g         Install globally to ~/.claude (not available with --copilot)
-  --force, -f          Overwrite existing files
-  --enterprise, -E     Enterprise mode (for init command)
-
-${colors.bright}Examples:${colors.reset}
-  npx tech-hub-skills install
-  npx tech-hub-skills install --copilot
-  npx tech-hub-skills install --global
-  npx tech-hub-skills init --enterprise
-  npx tech-hub-skills list
-
-${colors.bright}After Installation:${colors.reset}
-  Claude Code:    @orchestrator "Your project description"
-  GitHub Copilot: // Using AI Engineer approach for RAG pipeline
-  `);
-}
-
-// Parse arguments
-const args = process.argv.slice(2);
-const command = args[0];
-const options = {
-  global: args.includes('--global') || args.includes('-g'),
-  enterprise: args.includes('--enterprise') || args.includes('-E'),
-  copilot: args.includes('--copilot') || args.includes('-c'),
-  force: args.includes('--force') || args.includes('-f')
-};
-
-switch (command) {
-  case 'install':
-    printBanner();
-    install(options);
-    break;
-  case 'init':
-    init(options);
-    break;
-  case 'list':
-    list();
-    break;
-  case 'help':
-  case '--help':
-  case '-h':
-    showHelp();
-    break;
-  case 'version':
-  case '--version':
-  case '-v':
-    console.log(`tech-hub-skills v${VERSION}`);
-    break;
-  default:
-    showHelp();
-}