tech-hub-skills 1.6.0 → 1.6.5

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,191 +1,291 @@
-# Tech Hub Skills
+# Tech Hub Skills - Complete Role Documentation
 
-[![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)
+This document provides detailed information about all available roles and their skills.
 
-180+ production-ready AI agent skills for **Claude Code** and **GitHub Copilot**.
+For installation instructions, see the [main README](https://github.com/6ogo/Tech-Skills/blob/main/README.md).
 
-Enterprise-grade with security, governance, and compliance built-in.
+## Quick Reference
 
-## Quick Install
-
-### For Claude Code
+Use skills in Claude Code with `@` mentions:
 
 ```bash
-# npm/npx (Recommended)
-npx tech-hub-skills install
+# 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
+# Enterprise mode (mandatory security + governance)
+@project-starter --enterprise "Build a customer data platform"
 ```
 
-### For GitHub Copilot (VSCode)
+## Available Roles & Skills
 
-```bash
-# npm/npx
-npx tech-hub-skills install --copilot
+### Core Engineering (48 skills)
 
-# or Python
-pip install tech-hub-skills && tech-hub-skills install --copilot
-```
+| 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, Testing |
+| **Backend Developer**  | 7      | REST, GraphQL, Microservices, Caching        |
 
+### Architecture & Security Roles (22 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.
+| 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, DNS |
 
-### Global Install (Claude Code only)
+### Platform & Operations Roles (59 skills)
 
-```bash
-# Install globally for all projects
-npx tech-hub-skills install --global
-```
+| Role                  | Skills | Focus                                       |
+| --------------------- | ------ | ------------------------------------------- |
+| **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              |
+| **MLOps**             | 9      | Experiments, Registry, Deployment           |
+| **FinOps**            | 8      | Cost Visibility, Optimization               |
+| **Docker**            | 5      | Containers, Security, Optimization          |
 
-### Manual Installation
+### Enterprise Governance Roles (17 skills)
 
-```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/
-```
+| Role                      | Skills     | Focus                                   |
+| ------------------------- | ---------- | --------------------------------------- |
+| **Code Review**           | 5          | PR Automation, Quality Gates, Analytics |
+| **Compliance Officer**    | 7          | SOC 2, GDPR, HIPAA, PCI-DSS, ISO 27001  |
+| **Compliance Automation** | Integrated | Policy-as-Code, Evidence Collection     |
+| **Dashboard**             | Integrated | Security, Compliance, DORA Metrics      |
 
-## What's Included
+### Product, Design & Quality Roles (19 skills)
 
-- **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
+| Role                 | Skills | Focus                                     |
+| -------------------- | ------ | ----------------------------------------- |
+| **Product Designer** | 6      | Requirements, Research, UX, Brainstorming |
+| **QA Engineer**      | 7      | Test Strategy, Automation, Performance    |
+| **Technical Writer** | 6      | API Docs, ADRs, Runbooks, Knowledge Base  |
 
-## Available Roles
+### Cloud Platform Roles (36 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   |
-| **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                           |
+| --------- | ------ | ------------------------------- |
+| **Azure** | 12     | All Azure services              |
+| **AWS**   | 12     | EC2, Lambda, S3, RDS, VPC, EKS  |
+| **GCP**   | 12     | Compute, BigQuery, GKE, Pub/Sub |
 
-```bash
-# Start with the orchestrator
-/orchestrator "Build a customer churn prediction model"
+## Directory Structure
 
-# Or use specific roles
-/ai-engineer "Create a RAG pipeline"
-/security-architect "Review this code for PII"
-/data-engineer "Design a lakehouse architecture"
+```
+.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
 ```
 
-### GitHub Copilot
+## 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   |
+| Frontend Developer | `fe-`  | fe-01 to fe-07   |
+| Backend Developer  | `be-`  | be-01 to be-07   |
+| Security Architect | `sa-`  | sa-01 to sa-07   |
+| System Design      | `sd-`  | sd-01 to sd-08   |
+| Network Engineer   | `ne-`  | ne-01 to ne-07   |
+| Platform Engineer  | `pe-`  | pe-01 to pe-06   |
+| SRE                | `sr-`  | sr-01 to sr-07   |
+| Database Admin     | `db-`  | db-01 to db-07   |
+| 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   |
+| AWS                | `aws-` | aws-01 to aws-12 |
+| GCP                | `gcp-` | gcp-01 to gcp-12 |
+| Code Review        | `cr-`  | cr-01 to cr-05   |
+| Compliance Officer | `co-`  | co-01 to co-07   |
+| Product Designer   | `pd-`  | pd-01 to pd-06   |
+| QA Engineer        | `qa-`  | qa-01 to qa-07   |
+| Technical Writer   | `tw-`  | tw-01 to tw-06   |
+
+## Enterprise Mode
+
+For production applications, use Enterprise Mode to ensure security and governance:
 
-Copilot automatically applies expert knowledge. Reference roles in comments:
+```bash
+@project-starter --enterprise "Build a production API"
+```
 
-```python
-# Using AI Engineer approach for RAG pipeline
-def build_rag():
-    # Copilot suggests best practices
+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
 
-# Apply Security Architect principles
-def process_data(user_input):
-    # Copilot adds input validation, PII scanning
+### 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
 ```
 
-See [GITHUB_COPILOT.md](https://github.com/6ogo/Tech-Skills/blob/main/GITHUB_COPILOT.md) for complete guide.
+### Enterprise Quality Gates
 
-## Updating
+- No critical/high vulnerabilities
+- 80%+ code coverage
+- All compliance controls passing
+- Security architect sign-off
+- Data governance sign-off
 
-### Method 1 (Clone/ZIP)
+## Examples
+
+### AI/ML Project
 
 ```bash
-# Pull latest changes
-cd path/to/tech-hub-skills
-git pull
+@orchestrator "Build a customer churn prediction model with GDPR compliance"
+```
 
-# Copy updated files
-cp -r .claude your-project/
+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"
 ```
 
-After installation, use skills with `/` mentions:
+### Security Review
 
 ```bash
-# Start with the orchestrator (routes to all skills)
-/orchestrator "Build a customer churn prediction model"
+@security-architect "Audit this codebase for security vulnerabilities"
+```
 
-# Or invoke specific roles
-/ai-engineer "Create a RAG pipeline"
-/security-architect "Review this code for PII"
-/data-engineer "Design a lakehouse architecture"
+### Enterprise Platform
 
-# Enterprise mode (mandatory security + governance)
-/project-starter --enterprise "Build a customer data platform"
+```bash
+@project-starter --enterprise "Build a customer data platform"
 ```
 
-## Examples
+Auto-includes: ALL security + governance + compliance skills
 
-**AI/ML Project**
+## Integration Options
 
-```bash
-/orchestrator "Build a customer churn prediction model with GDPR compliance"
+### Claude Code (Primary)
+
+Skills are designed for Claude Code's `@` mention system.
+
+### CrewAI
+
+```python
+from crewai import Agent, Task, Crew
+
+orchestrator = Agent(
+    role="Tech Hub Orchestrator",
+    goal="Coordinate skills for optimal project execution",
+    backstory=open(".claude/skills/orchestrator.md").read()
+)
 ```
 
-**RAG Application**
+### LangGraph
 
-```bash
-/ai-engineer "Create a RAG pipeline for internal docs"
+```python
+from langgraph.graph import StateGraph
+
+# Load skills as node definitions
+skills = load_skills(".claude/skills/")
 ```
 
-**Security Review**
+## Integration Options
 
-```bash
-/security-architect "Audit this codebase for security vulnerabilities"
+### Claude Code (Primary)
+
+Skills are designed for Claude Code's `@` mention system.
+
+### CrewAI
+
+```python
+from crewai import Agent, Task, Crew
+
+orchestrator = Agent(
+    role="Tech Hub Orchestrator",
+    goal="Coordinate skills for optimal project execution",
+    backstory=open(".claude/skills/orchestrator.md").read()
+)
 ```
 
-**Enterprise Platform**
+### LangGraph
 
-```bash
-/project-starter --enterprise "Build a customer data platform"
+```python
+from langgraph.graph import StateGraph
+
+# Load skills as node definitions
+skills = load_skills(".claude/skills/")
 ```
 
-## Documentation
+## Repository Structure
 
-- **All Roles**: See [.claude/README.md](https://github.com/6ogo/Tech-Skills/blob/main/.claude/README.md) for complete role documentation
+```
+.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
+```
 
 ## Contributing
 
 1. Fork the repository
-2. Add skills to `.claude/roles/{role}/skills/{skill-id}/`
-3. Update `.claude/skills/{role}.md`
+2. Add skills to `roles/{role}/skills/{skill-id}/`
+3. Update `skills/{role}.md`
 4. Submit PR
 
+For publishing instructions (maintainers only), see [PUBLISHING.md](https://github.com/6ogo/Tech-Skills/blob/main/PUBLISHING.md).
+
 ## License
 
 MIT

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.5",
+  "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"
   }
 }