npm - tech-hub-skills - Versions diffs - 1.6.5 → 1.6.7 - Mend

tech-hub-skills 1.6.5 → 1.6.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -1,12 +1,29 @@
-# Tech Hub Skills - Complete Role Documentation
+# Tech Hub Skills
-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).
+[![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)
-## Quick Reference
+## Installation
-Use skills in Claude Code with `@` mentions:
+```bash
+# Install the package
+npm install tech-hub-skills
+# Install skills to your project's .claude folder
+npx 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
+```
+## Quick Start
+After installation, use skills in Claude Code with `@` mentions:
 ```bash
 # Start with the orchestrator (routes to all skills)
@@ -25,146 +42,117 @@ Use skills in Claude Code with `@` mentions:
 ### 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
+| 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 |
+### Architecture & Security (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 |
+### Platform & Operations (59 skills)
+| 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 |
+### Cloud Platforms (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 |
+### Enterprise Governance (17 skills)
+| 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 |
+### Product, Design & Quality (19 skills)
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Product Designer** | 6 | Requirements, Research, UX |
+| **QA Engineer** | 7 | Test Strategy, Automation |
+| **Technical Writer** | 6 | API Docs, ADRs, Runbooks |
+## CLI Commands
+```bash
+# Install skills to current project
+npx tech-hub-skills install
+# Install with GitHub Copilot integration
+npx tech-hub-skills install --copilot
+# Install globally
+npx tech-hub-skills install --global
+# Force overwrite existing installation
+npx tech-hub-skills install --force
+# Initialize with enterprise mode
+npx tech-hub-skills init --enterprise
+# List all available roles
+npx tech-hub-skills list
+# Show help
+npx tech-hub-skills help
 ```
-.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   |
+## Directory Structure (After Installation)
+```
+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
+```
 ## Enterprise Mode
-For production applications, use Enterprise Mode to ensure security and governance:
+For production applications, use Enterprise Mode:
 ```bash
 @project-starter --enterprise "Build a production API"
 ```
-Enterprise Mode **automatically includes**:
+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
@@ -176,115 +164,39 @@ Monitoring → Continuous Compliance
 ## 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
+## Python Installation
-### Claude Code (Primary)
+Also available via pip:
-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
+```bash
+pip install tech-hub-skills
+tech-hub-skills install
 ```
-## Contributing
-1. Fork the repository
-2. Add skills to `roles/{role}/skills/{skill-id}/`
-3. Update `skills/{role}.md`
-4. Submit PR
+## Links
-For publishing instructions (maintainers only), see [PUBLISHING.md](https://github.com/6ogo/Tech-Skills/blob/main/PUBLISHING.md).
+- [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/bin/cli.js CHANGED Viewed

@@ -60,10 +60,21 @@ function copyDir(src, dest) {
 }
 function install(options = {}) {
-  const isGlobal = options.global;
+  const isGlobal = options.global || process.env.npm_config_global === "true";
+  const projectRoot = process.env.INIT_CWD || process.cwd();
   const targetDir = isGlobal
     ? path.join(require("os").homedir(), ".claude")
-    : path.join(process.cwd(), ".claude");
+    : path.join(projectRoot, ".claude");
+  // Prevent self-copying if running from the source repo
+  if (path.resolve(SKILLS_DIR) === path.resolve(targetDir)) {
+    print(
+      "\nℹ️  Running from source directory, skipping installation to avoid self-overwrite.",
+      "yellow"
+    );
+    return;
+  }
   print(`\n📦 Installing Tech Hub Skills to: ${targetDir}`, "cyan");
@@ -255,7 +266,10 @@ ${colors.bright}After Installation:${colors.reset}
 const args = process.argv.slice(2);
 const command = args[0];
 const options = {
-  global: args.includes("--global") || args.includes("-g"),
+  global:
+    args.includes("--global") ||
+    args.includes("-g") ||
+    process.env.npm_config_global === "true",
   enterprise: args.includes("--enterprise") || args.includes("-E"),
   copilot: args.includes("--copilot") || args.includes("-c"),
   force: args.includes("--force") || args.includes("-f"),

package/bin/postinstall.js CHANGED Viewed

@@ -6,37 +6,54 @@
  */
 const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
+  reset: "\x1b[0m",
+  bright: "\x1b[1m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
 };
-console.log(`
-${colors.cyan}
-╔═══════════════════════════════════════════════════════════╗
-║         TECH HUB SKILLS - Successfully Installed!         ║
-╚═══════════════════════════════════════════════════════════╝${colors.reset}
-${colors.green}✓ Package installed successfully!${colors.reset}
+async function runInstall() {
+  try {
+    const cliPath = path.join(__dirname, "cli.js");
+    // Determine if it's a global install
+    const isGlobal = process.env.npm_config_global === "true";
+    if (isGlobal) {
+      console.log(
+        `${colors.cyan}Installing Tech Hub Skills globally...${colors.reset}`
+      );
+      execSync(`node "${cliPath}" install --global`, { stdio: "inherit" });
+    } else {
+      console.log(
+        `${colors.cyan}Installing Tech Hub Skills to project...${colors.reset}`
+      );
+      // Use INIT_CWD if available (set by npm), otherwise process.cwd()
+      const targetDir = process.env.INIT_CWD || process.cwd();
+      execSync(`node "${cliPath}" install`, {
+        stdio: "inherit",
+        env: { ...process.env, INIT_CWD: targetDir },
+      });
+    }
+    console.log(`
+${colors.green}✓ Tech Hub Skills auto-installation complete!${colors.reset}
 ${colors.bright}Next Steps:${colors.reset}
+  - In Claude Code: Type ${colors.yellow}/orchestrator${colors.reset} or ${colors.yellow}@orchestrator${colors.reset}
+  - View all skills:  ${colors.cyan}npx tech-hub-skills list${colors.reset}
+`);
+  } catch (error) {
+    console.log(`
+${colors.yellow}⚠️  Auto-installation partially skipped or failed.${colors.reset}
+This is normal if you are developing the package itself or have strict permissions.
-  1. Install skills to your project:
-     ${colors.cyan}npx tech-hub-skills install${colors.reset}
-  2. Or install globally:
-     ${colors.cyan}npx tech-hub-skills install --global${colors.reset}
-  3. View all available skills:
-     ${colors.cyan}npx tech-hub-skills list${colors.reset}
-${colors.bright}Quick Start:${colors.reset}
-  After installing, use in Claude Code:
-  ${colors.yellow}@orchestrator "Build a customer churn prediction model"${colors.reset}
-${colors.bright}Documentation:${colors.reset}
-  https://github.com/6ogo/Tech-Skills
+To manually install skills, run:
+  ${colors.cyan}npx tech-hub-skills install${colors.reset}
 `);
+  }
+}
+runInstall();

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "tech-hub-skills",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "description": "180+ production-ready AI agent skills for Claude Code and GitHub Copilot",
   "main": "bin/cli.js",
   "bin": {