tech-hub-skills 1.2.0 → 1.5.1

package/README.md

@@ -1,291 +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 the [main README](https://github.com/6ogo/Tech-Skills/blob/main/README.md).
+## Quick Install
 
-## Quick Reference
+### For Claude Code
 
-Use skills in Claude Code with `@` mentions:
+```bash
+# npm/npx (Recommended)
+npx tech-hub-skills install
+
+# or Python
+pip install tech-hub-skills && tech-hub-skills install
+```
+
+### For GitHub Copilot (VSCode)
 
 ```bash
-# Start with the orchestrator (routes to all skills)
-@orchestrator "Build a customer churn prediction model"
+# npm/npx
+npx tech-hub-skills install --copilot
 
-# 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"
+This creates `.github/copilot-instructions.md` with all expert skills.
+See [GITHUB_COPILOT.md](GITHUB_COPILOT.md) for usage guide.
+
+### Global Install (Claude Code only)
+
+```bash
+# Install globally for all projects
+npx tech-hub-skills install --global
 ```
 
-## Available Roles & Skills
+### Manual Installation
+
+```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/
+```
 
-### Core Engineering (48 skills)
+## What's Included
 
-| 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        |
+- **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
 
-### Architecture & Security Roles (22 skills)
+## 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, DNS |
+| **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:
 
-### Platform & Operations Roles (59 skills)
+```bash
+# Start with the orchestrator
+@orchestrator "Build a customer churn prediction model"
 
-| 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          |
+# Or use specific roles
+@ai-engineer "Create a RAG pipeline"
+@security-architect "Review this code for PII"
+@data-engineer "Design a lakehouse architecture"
+```
 
-### Enterprise Governance Roles (17 skills)
+### GitHub Copilot
 
-| 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      |
+Copilot automatically applies expert knowledge. Reference roles in comments:
 
-### Product, Design & Quality Roles (19 skills)
+```python
+# Using AI Engineer approach for RAG pipeline
+def build_rag():
+    # Copilot suggests best practices
 
-| 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  |
+# Apply Security Architect principles
+def process_data(user_input):
+    # Copilot adds input validation, PII scanning
+```
 
-### Cloud Platform Roles (36 skills)
+See [GITHUB_COPILOT.md](GITHUB_COPILOT.md) for complete guide.
 
-| Role      | Skills | Focus                           |
-| --------- | ------ | ------------------------------- |
-| **Azure** | 12     | All Azure services              |
-| **AWS**   | 12     | EC2, Lambda, S3, RDS, VPC, EKS  |
-| **GCP**   | 12     | Compute, BigQuery, GKE, Pub/Sub |
+## Updating
 
-## 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
-```
-
-## 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:
+### Method 1 (Clone/ZIP)
 
 ```bash
-@project-starter --enterprise "Build a production API"
+# Pull latest changes
+cd path/to/tech-hub-skills
+git pull
+
+# Copy updated files
+cp -r .claude your-project/
 ```
 
-Enterprise Mode **automatically includes**:
+After installation, use skills with `@` mentions:
 
-- Security Architect (sa-01 to sa-07)
-- Data Governance (dg-01 to dg-06)
-- Code Review (cr-01 to cr-05)
-- Compliance Automation
+```bash
+# Start with the orchestrator (routes to all skills)
+@orchestrator "Build a customer churn prediction model"
 
-### Enterprise Workflow
+# Or invoke specific roles
+@ai-engineer "Create a RAG pipeline"
+@security-architect "Review this code for PII"
+@data-engineer "Design a lakehouse architecture"
 
+# Enterprise mode (mandatory security + governance)
+@project-starter --enterprise "Build a customer data platform"
 ```
-Requirements → Security Assessment → Data Classification
-     ↓
-Architecture → Security Review → Governance Review
-     ↓
-Development → Code Review → Compliance Check
-     ↓
-Deployment → Security Scan → Production Approval
-     ↓
-Monitoring → Continuous Compliance
-```
-
-### 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
+**AI/ML Project**
 
 ```bash
 @orchestrator "Build a customer churn prediction model with GDPR compliance"
 ```
 
-Auto-includes: sa-01 (PII), dg-01 (catalog), ml-01-05, mo-01-06
-
-### RAG Application
+**RAG Application**
 
 ```bash
-@ai-engineer ai-02 "Create a RAG pipeline for internal docs"
+@ai-engineer "Create a RAG pipeline for internal docs"
 ```
 
-### Security Review
+**Security Review**
 
 ```bash
 @security-architect "Audit this codebase for security vulnerabilities"
 ```
 
-### Enterprise Platform
+**Enterprise Platform**
 
 ```bash
 @project-starter --enterprise "Build a customer data platform"
 ```
 
-Auto-includes: ALL security + governance + compliance skills
-
-## Integration Options
-
-### Claude Code (Primary)
-
-Skills are designed for Claude Code's `@` mention system.
+## Documentation
 
-### 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()
-)
-```
-
-### LangGraph
-
-```python
-from langgraph.graph import StateGraph
-
-# Load skills as node definitions
-skills = load_skills(".claude/skills/")
-```
-
-## Integration Options
-
-### 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()
-)
-```
-
-### LangGraph
-
-```python
-from langgraph.graph import StateGraph
-
-# Load skills as node definitions
-skills = load_skills(".claude/skills/")
-```
-
-## Repository 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
-│   └── ...
-├── roles/                  # Detailed skill implementations
-│   ├── ai-engineer/
-│   │   └── skills/
-│   │       ├── 01-prompt-engineering/README.md
-│   │       ├── 02-rag-pipeline/README.md
-│   │       └── ...
-│   └── ...
-└── README.md               # This file
-```
+- **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](https://github.com/6ogo/Tech-Skills/blob/main/PUBLISHING.md).
-
 ## License
 
 MIT

package/package.json

@@ -1,46 +1,8 @@
 {
   "name": "tech-hub-skills",
-  "version": "1.2.0",
-  "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"
-  },
-  "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",
-  "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"
   }
 }