tech-hub-skills 1.6.0 → 1.6.6

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 George
+Copyright (c) 2025 6ogo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,190 +1,202 @@
 # Tech Hub Skills
 
-[![npm version](https://img.shields.io/npm/v/tech-hub-skills.svg)](https://www.npmjs.com/package/tech-hub-skills)
-[![npm downloads](https://img.shields.io/npm/dm/tech-hub-skills.svg)](https://www.npmjs.com/package/tech-hub-skills)
-[![npm total downloads](https://img.shields.io/npm/dt/tech-hub-skills.svg)](https://www.npmjs.com/package/tech-hub-skills)
-[![License](https://img.shields.io/npm/l/tech-hub-skills.svg)](https://github.com/6ogo/Tech-Skills/blob/main/LICENSE)
+**180+ production-ready AI agent skills for Claude Code and GitHub Copilot**
 
-180+ production-ready AI agent skills for **Claude Code** and **GitHub Copilot**.
+[![npm version](https://badge.fury.io/js/tech-hub-skills.svg)](https://www.npmjs.com/package/tech-hub-skills)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Enterprise-grade with security, governance, and compliance built-in.
-
-## Quick Install
-
-### For Claude Code
+## Installation
 
 ```bash
-# npm/npx (Recommended)
+# Install the package
+npm install tech-hub-skills
+
+# Install skills to your project's .claude folder
 npx tech-hub-skills install
 
-# or Python
-pip install tech-hub-skills && tech-hub-skills install
+# Or install globally to ~/.claude
+npx tech-hub-skills install --global
+
+# With GitHub Copilot integration
+npx tech-hub-skills install --copilot
 ```
 
-### For GitHub Copilot (VSCode)
+## Quick Start
+
+After installation, use skills in Claude Code with `@` mentions:
 
 ```bash
-# npm/npx
-npx tech-hub-skills install --copilot
+# 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"
 
-# or Python
-pip install tech-hub-skills && tech-hub-skills install --copilot
+# Enterprise mode (mandatory security + governance)
+@project-starter --enterprise "Build a customer data platform"
 ```
 
+## Available Roles & Skills
 
-This creates `.github/copilot-instructions.md` with all expert skills.
-See [GITHUB_COPILOT.md](https://github.com/6ogo/Tech-Skills/blob/main/GITHUB_COPILOT.md) for usage guide.
+### Core Engineering (48 skills)
 
-### Global Install (Claude Code only)
+| 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 |
 
-```bash
-# Install globally for all projects
-npx tech-hub-skills install --global
-```
+### Architecture & Security (22 skills)
 
-### Manual Installation
+| Role | Skills | Focus |
+|------|--------|-------|
+| **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 |
 
-```bash
-# 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/
-```
+### Platform & Operations (59 skills)
 
-## 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](https://github.com/6ogo/Tech-Skills/blob/main/.claude/README.md) for detailed role documentation.
-
-## Usage
-
-### Claude Code
-
-Use `/` mentions to invoke specific expert roles:
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Platform Engineer** | 6 | IDP, Self-Service, SLOs |
+| **SRE** | 7 | Incident Response, Chaos Engineering |
+| **Database Admin** | 7 | Query Optimization, Replication |
+| **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 |
 
-```bash
-# Start with the orchestrator
-/orchestrator "Build a customer churn prediction model"
+### Cloud Platforms (36 skills)
 
-# Or use specific roles
-/ai-engineer "Create a RAG pipeline"
-/security-architect "Review this code for PII"
-/data-engineer "Design a lakehouse architecture"
-```
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Azure** | 12 | All Azure services |
+| **AWS** | 12 | EC2, Lambda, S3, RDS, VPC, EKS |
+| **GCP** | 12 | Compute, BigQuery, GKE, Pub/Sub |
 
-### GitHub Copilot
+### Enterprise Governance (17 skills)
 
-Copilot automatically applies expert knowledge. Reference roles in comments:
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Code Review** | 5 | PR Automation, Quality Gates |
+| **Compliance Officer** | 7 | SOC 2, GDPR, HIPAA, PCI-DSS |
+| **Compliance Automation** | Integrated | Policy-as-Code, Evidence Collection |
 
-```python
-# Using AI Engineer approach for RAG pipeline
-def build_rag():
-    # Copilot suggests best practices
+### Product, Design & Quality (19 skills)
 
-# Apply Security Architect principles
-def process_data(user_input):
-    # Copilot adds input validation, PII scanning
-```
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Product Designer** | 6 | Requirements, Research, UX |
+| **QA Engineer** | 7 | Test Strategy, Automation |
+| **Technical Writer** | 6 | API Docs, ADRs, Runbooks |
 
-See [GITHUB_COPILOT.md](https://github.com/6ogo/Tech-Skills/blob/main/GITHUB_COPILOT.md) for complete guide.
+## CLI Commands
+
+```bash
+# Install skills to current project
+npx tech-hub-skills install
 
-## Updating
+# Install with GitHub Copilot integration
+npx tech-hub-skills install --copilot
 
-### Method 1 (Clone/ZIP)
+# Install globally
+npx tech-hub-skills install --global
 
-```bash
-# Pull latest changes
-cd path/to/tech-hub-skills
-git pull
+# Force overwrite existing installation
+npx tech-hub-skills install --force
 
-# Copy updated files
-cp -r .claude your-project/
-```
+# Initialize with enterprise mode
+npx tech-hub-skills init --enterprise
 
-After installation, use skills with `/` mentions:
+# List all available roles
+npx tech-hub-skills list
 
-```bash
-# Start with the orchestrator (routes to all skills)
-/orchestrator "Build a customer churn prediction model"
+# Show help
+npx tech-hub-skills help
+```
 
-# Or invoke specific roles
-/ai-engineer "Create a RAG pipeline"
-/security-architect "Review this code for PII"
-/data-engineer "Design a lakehouse architecture"
+## Directory Structure (After Installation)
 
-# Enterprise mode (mandatory security + governance)
-/project-starter --enterprise "Build a customer data platform"
+```
+your-project/
+└── .claude/
+    ├── skills/                 # Role skill files
+    │   ├── orchestrator.md     # Main orchestrator
+    │   ├── ai-engineer.md
+    │   ├── data-engineer.md
+    │   ├── security-architect.md
+    │   └── ...
+    ├── roles/                  # Detailed skill implementations
+    │   ├── ai-engineer/skills/
+    │   ├── security-architect/skills/
+    │   └── ...
+    └── commands/               # CLI commands for Claude Code
 ```
 
-## Examples
+## Enterprise Mode
 
-**AI/ML Project**
+For production applications, use Enterprise Mode:
 
 ```bash
-/orchestrator "Build a customer churn prediction model with GDPR compliance"
+@project-starter --enterprise "Build a production API"
 ```
 
-**RAG Application**
+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
+
+### Enterprise Quality Gates
+
+- No critical/high vulnerabilities
+- 80%+ code coverage
+- All compliance controls passing
+- Security architect sign-off
+- Data governance sign-off
 
+## Examples
+
+### AI/ML Project
 ```bash
-/ai-engineer "Create a RAG pipeline for internal docs"
+@orchestrator "Build a customer churn prediction model with GDPR compliance"
 ```
 
-**Security Review**
-
+### RAG Application
 ```bash
-/security-architect "Audit this codebase for security vulnerabilities"
+@ai-engineer ai-02 "Create a RAG pipeline for internal docs"
 ```
 
-**Enterprise Platform**
+### Security Review
+```bash
+@security-architect "Audit this codebase for security vulnerabilities"
+```
 
+### Enterprise Platform
 ```bash
-/project-starter --enterprise "Build a customer data platform"
+@project-starter --enterprise "Build a customer data platform"
 ```
 
-## Documentation
+## Python Installation
+
+Also available via pip:
 
-- **All Roles**: See [.claude/README.md](https://github.com/6ogo/Tech-Skills/blob/main/.claude/README.md) for complete role documentation
+```bash
+pip install tech-hub-skills
+tech-hub-skills install
+```
 
-## Contributing
+## Links
 
-1. Fork the repository
-2. Add skills to `.claude/roles/{role}/skills/{skill-id}/`
-3. Update `.claude/skills/{role}.md`
-4. Submit PR
+- [GitHub Repository](https://github.com/6ogo/Tech-Skills)
+- [Issues](https://github.com/6ogo/Tech-Skills/issues)
+- [Full Documentation](https://github.com/6ogo/Tech-Skills/blob/main/README.md)
 
 ## License
 

package/{.claude/bin → bin}/cli.js

@@ -67,26 +67,47 @@ function install(options = {}) {
 
   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");
+  // Try multiple source paths (support both package layouts)
+  const possibleSkillsSrc = [
+    path.join(SKILLS_DIR, "skills"),
+    path.join(SKILLS_DIR, "tech_hub_skills", "skills"),
+  ];
+  const possibleRolesSrc = [
+    path.join(SKILLS_DIR, "roles"),
+    path.join(SKILLS_DIR, "tech_hub_skills", "roles"),
+  ];
+  const possibleCommandsSrc = [
+    path.join(SKILLS_DIR, "commands"),
+    path.join(SKILLS_DIR, "tech_hub_skills", "skills"), // fallback to skills
+  ];
+
   const skillsDest = path.join(targetDir, "skills");
   const rolesDest = path.join(targetDir, "roles");
   const commandsDest = path.join(targetDir, "commands");
 
-  if (fs.existsSync(skillsSrc)) {
+  // Find and copy skills
+  const skillsSrc = possibleSkillsSrc.find((p) => fs.existsSync(p));
+  if (skillsSrc) {
     print("  Copying skills...", "yellow");
     copyDir(skillsSrc, skillsDest);
-
-    print("  Copying commands...", "yellow");
-    copyDir(skillsSrc, commandsDest);
+  } else {
+    print("  ⚠️  Skills directory not found", "red");
   }
 
-  if (fs.existsSync(rolesSrc)) {
+  // Find and copy roles
+  const rolesSrc = possibleRolesSrc.find((p) => fs.existsSync(p));
+  if (rolesSrc) {
     print("  Copying roles...", "yellow");
     copyDir(rolesSrc, rolesDest);
   }
 
+  // Find and copy commands
+  const commandsSrc = possibleCommandsSrc.find((p) => fs.existsSync(p));
+  if (commandsSrc) {
+    print("  Copying commands...", "yellow");
+    copyDir(commandsSrc, commandsDest);
+  }
+
   // Install GitHub Copilot instructions if requested (project-level only)
   if (options.copilot && !isGlobal) {
     print("\n🤖 Installing GitHub Copilot integration...", "cyan");

package/package.json

@@ -1,16 +1,49 @@
 {
   "name": "tech-hub-skills",
-  "version": "1.6.0",
-  "description": "Collection of tech skills for Claude Code",
+  "version": "1.6.6",
+  "description": "180+ 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"
   },
-  "homepage": "https://github.com/6ogo/Tech-Skills#readme",
+  "files": [
+    "skills/**/*.md",
+    "roles/**/*.md",
+    "commands/**/*.md",
+    "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",
   "bugs": {
     "url": "https://github.com/6ogo/Tech-Skills/issues"
-  },
-  "dependencies": {
-    "tech-hub-skills": "^1.6.0"
   }
 }