tech-hub-skills 1.2.0 → 1.5.2

package/README.md

@@ -1,291 +1,192 @@
-# Tech Hub Skills - Complete Role Documentation
-
-This document provides detailed information about all available roles and their skills.
-
-For installation instructions, see the [main README](https://github.com/6ogo/Tech-Skills/blob/main/README.md).
-
-## Quick Reference
-
-Use skills in Claude Code with `@` mentions:
-
-```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"
-
-# Enterprise mode (mandatory security + governance)
-@project-starter --enterprise "Build a customer data platform"
-```
-
-## Available Roles & Skills
-
-### Core Engineering (48 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, Testing |
-| **Backend Developer**  | 7      | REST, GraphQL, Microservices, Caching        |
-
-### Architecture & Security Roles (22 skills)
-
-| 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 |
-
-### Platform & Operations Roles (59 skills)
-
-| 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          |
-
-### Enterprise Governance Roles (17 skills)
-
-| 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      |
-
-### Product, Design & Quality Roles (19 skills)
-
-| 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  |
-
-### Cloud Platform Roles (36 skills)
-
-| Role      | Skills | Focus                           |
-| --------- | ------ | ------------------------------- |
-| **Azure** | 12     | All Azure services              |
-| **AWS**   | 12     | EC2, Lambda, S3, RDS, VPC, EKS  |
-| **GCP**   | 12     | Compute, BigQuery, GKE, Pub/Sub |
-
-## 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:
-
-```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
-
-### 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
-```
-
-### 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
-@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
-
-```bash
-@ai-engineer ai-02 "Create a RAG pipeline for internal docs"
-```
-
-### Security Review
-
-```bash
-@security-architect "Audit this codebase for security vulnerabilities"
-```
-
-### 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.
-
-### 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
-```
-
-## Contributing
-
-1. Fork the repository
-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
+# 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**.
+
+Enterprise-grade with security, governance, and compliance built-in.
+
+## Quick Install
+
+### For Claude Code
+
+```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
+# npm/npx
+npx tech-hub-skills install --copilot
+
+# or Python
+pip install tech-hub-skills && tech-hub-skills install --copilot
+```
+
+
+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.
+
+### Global Install (Claude Code only)
+
+```bash
+# Install globally for all projects
+npx tech-hub-skills install --global
+```
+
+### 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/
+```
+
+## 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:
+
+```bash
+# 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"
+```
+
+### GitHub Copilot
+
+Copilot automatically applies expert knowledge. Reference roles in comments:
+
+```python
+# Using AI Engineer approach for RAG pipeline
+def build_rag():
+    # Copilot suggests best practices
+
+# Apply Security Architect principles
+def process_data(user_input):
+    # Copilot adds input validation, PII scanning
+```
+
+See [GITHUB_COPILOT.md](https://github.com/6ogo/Tech-Skills/blob/main/GITHUB_COPILOT.md) for complete guide.
+
+## Updating
+
+### Method 1 (Clone/ZIP)
+
+```bash
+# Pull latest changes
+cd path/to/tech-hub-skills
+git pull
+
+# Copy updated files
+cp -r .claude your-project/
+```
+
+After installation, use skills with `/` mentions:
+
+```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"
+
+# Enterprise mode (mandatory security + governance)
+/project-starter --enterprise "Build a customer data platform"
+```
+
+## Examples
+
+**AI/ML Project**
+
+```bash
+/orchestrator "Build a customer churn prediction model with GDPR compliance"
+```
+
+**RAG Application**
+
+```bash
+/ai-engineer "Create a RAG pipeline for internal docs"
+```
+
+**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](https://github.com/6ogo/Tech-Skills/blob/main/.claude/README.md) for complete role documentation
+- **Publishing**: See [PUBLISHING.md](https://github.com/6ogo/Tech-Skills/blob/main/PUBLISHING.md) for maintainer instructions
+
+## Contributing
+
+1. Fork the repository
+2. Add skills to `.claude/roles/{role}/skills/{skill-id}/`
+3. Update `.claude/skills/{role}.md`
+4. Submit PR
+
+## License
+
+MIT

package/package.json

@@ -1,46 +1,16 @@
-{
-  "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"
-  }
-}
+{
+  "name": "tech-hub-skills",
+  "version": "1.5.2",
+  "description": "Collection of tech skills for Claude Code",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/6ogo/Tech-Skills.git"
+  },
+  "homepage": "https://github.com/6ogo/Tech-Skills#readme",
+  "bugs": {
+    "url": "https://github.com/6ogo/Tech-Skills/issues"
+  },
+  "dependencies": {
+    "tech-hub-skills": "^1.5.1"
+  }
+}