tech-hub-skills 1.2.0 → 1.5.2

package/{LICENSE → .claude/LICENSE}

@@ -1,21 +1,21 @@
-MIT License
-
-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
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.claude/README.md

@@ -0,0 +1,291 @@
+# 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

package/.claude/bin/cli.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { installCopilotInstructions } = require("./copilot");
+
+const SKILLS_DIR = path.join(__dirname, "..");
+const VERSION = require("../package.json").version;
+
+const colors = {
+  reset: "\x1b[0m",
+  bright: "\x1b[1m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  magenta: "\x1b[35m",
+};
+
+function print(msg, color = "reset") {
+  console.log(`${colors[color]}${msg}${colors.reset}`);
+}
+
+function printBanner() {
+  console.log(`
+${colors.cyan}╔═══════════════════════════════════════════════════════════╗
+║         TECH HUB SKILLS - AI Agent Skills for Claude       ║
+║                  110+ Production-Ready Skills               ║
+╚═══════════════════════════════════════════════════════════╝${colors.reset}
+  `);
+}
+
+function copyDir(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip bin, node_modules, package.json
+    if (
+      ["bin", "node_modules", "package.json", "package-lock.json"].includes(
+        entry.name
+      )
+    ) {
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function install(options = {}) {
+  const isGlobal = options.global;
+  const targetDir = isGlobal
+    ? path.join(require("os").homedir(), ".claude")
+    : path.join(process.cwd(), ".claude");
+
+  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");
+  const skillsDest = path.join(targetDir, "skills");
+  const rolesDest = path.join(targetDir, "roles");
+  const commandsDest = path.join(targetDir, "commands");
+
+  if (fs.existsSync(skillsSrc)) {
+    print("  Copying skills...", "yellow");
+    copyDir(skillsSrc, skillsDest);
+
+    print("  Copying commands...", "yellow");
+    copyDir(skillsSrc, commandsDest);
+  }
+
+  if (fs.existsSync(rolesSrc)) {
+    print("  Copying roles...", "yellow");
+    copyDir(rolesSrc, rolesDest);
+  }
+
+  // Install GitHub Copilot instructions if requested (project-level only)
+  if (options.copilot && !isGlobal) {
+    print("\n🤖 Installing GitHub Copilot integration...", "cyan");
+    installCopilotInstructions({ force: options.force });
+  } else if (options.copilot && isGlobal) {
+    print(
+      "\n⚠️  Copilot integration is only available for project-level installs",
+      "yellow"
+    );
+    print(
+      "    (Copilot instructions must be in project .github/ directory)",
+      "yellow"
+    );
+  }
+
+  // Count installed files
+  const skillCount = fs.existsSync(skillsDest)
+    ? fs.readdirSync(skillsDest).filter((f) => f.endsWith(".md")).length
+    : 0;
+
+  print(`\n✓ Installation complete!`, "green");
+  print(`  Location: ${targetDir}`, "cyan");
+  print(`  Skills: ${skillCount} role files installed`, "cyan");
+  print(`  Roles: 16+ specialized agents`, "cyan");
+  if (options.copilot && !isGlobal) {
+    print(`  Copilot: .github/copilot-instructions.md`, "cyan");
+  }
+
+  print(`\n${colors.bright}Next Steps:${colors.reset}`);
+  if (options.copilot && !isGlobal) {
+    print("  GitHub Copilot:");
+    print("  1. Open VSCode with GitHub Copilot enabled");
+    print("  2. Copilot will automatically use the instructions");
+    print("  3. Try: // Using AI Engineer approach for RAG pipeline");
+    print("");
+  }
+  print("  Claude Code:");
+  print("  1. Open Claude Code in your project");
+  print("  2. Use /orchestrator or @orchestrator to start");
+  print(
+    "  3. Or invoke specific roles: /ai-engineer, /security-architect, etc."
+  );
+
+  print(`\n${colors.bright}Example:${colors.reset}`);
+  if (options.copilot && !isGlobal) {
+    print("  Copilot: // Apply Security Architect best practices");
+  }
+  print('  Claude: /orchestrator "Build a customer churn prediction model"');
+  print('  Claude: @orchestrator "Build a customer churn prediction model"');
+}
+
+function init(options = {}) {
+  printBanner();
+
+  if (options.enterprise) {
+    print("\n🏢 ENTERPRISE MODE", "magenta");
+    print("   Mandatory: Security Architect + Data Governance", "yellow");
+    print("\n   Use in Claude Code:", "cyan");
+    print('   @project-starter --enterprise "Your project description"');
+  } else {
+    print("\n📦 Standard Mode", "cyan");
+    print("\n   Use in Claude Code:", "cyan");
+    print('   @project-starter "Your project description"');
+  }
+}
+
+function list() {
+  printBanner();
+
+  const roles = [
+    {
+      name: "Orchestrator",
+      skills: "Routes all",
+      focus: "Project coordination",
+    },
+    { name: "AI Engineer", skills: "8", focus: "LLMs, RAG, Agents" },
+    { name: "Data Engineer", skills: "9", focus: "Pipelines, Lakehouse" },
+    { name: "ML Engineer", skills: "9", focus: "Training, Serving, MLOps" },
+    { name: "Data Scientist", skills: "8", focus: "Analytics, Modeling" },
+    { name: "Security Architect", skills: "7", focus: "PII, IAM, Compliance" },
+    { name: "System Design", skills: "8", focus: "Architecture, Scalability" },
+    { name: "Platform Engineer", skills: "6", focus: "IDP, SLOs" },
+    {
+      name: "Data Governance",
+      skills: "6",
+      focus: "Catalog, Lineage, Quality",
+    },
+    { name: "DevOps", skills: "9", focus: "CI/CD, Containers, IaC" },
+    { name: "MLOps", skills: "9", focus: "Experiments, Registry" },
+    { name: "FinOps", skills: "8", focus: "Cost Optimization" },
+    { name: "Azure", skills: "12", focus: "Azure Services" },
+    { name: "Code Review", skills: "5", focus: "PR Automation, Quality Gates" },
+    { name: "Product Designer", skills: "6", focus: "Requirements, UX" },
+  ];
+
+  print("\nAvailable Roles:\n", "bright");
+  console.log("  Role                 Skills   Focus");
+  console.log("  ────────────────────────────────────────────────");
+
+  for (const role of roles) {
+    const name = role.name.padEnd(20);
+    const skills = role.skills.toString().padEnd(8);
+    console.log(`  ${name} ${skills} ${role.focus}`);
+  }
+
+  print("\n  Total: 110+ skills across 16+ roles", "cyan");
+}
+
+function showHelp() {
+  printBanner();
+  console.log(`
+${colors.bright}Usage:${colors.reset}
+  npx tech-hub-skills <command> [options]
+
+${colors.bright}Commands:${colors.reset}
+  install              Install skills to current project (Claude Code)
+  install --copilot    Install with GitHub Copilot integration
+  install --global     Install skills globally (~/.claude)
+  install --force      Force overwrite existing installation
+  init                 Initialize project with guided setup
+  init --enterprise    Enterprise mode with security + governance
+  list                 List all available roles and skills
+  help                 Show this help message
+
+${colors.bright}Options:${colors.reset}
+  --copilot, -c        Add GitHub Copilot instructions (.github/copilot-instructions.md)
+  --global, -g         Install globally to ~/.claude (not available with --copilot)
+  --force, -f          Overwrite existing files
+  --enterprise, -E     Enterprise mode (for init command)
+
+${colors.bright}Examples:${colors.reset}
+  npx tech-hub-skills install
+  npx tech-hub-skills install --copilot
+  npx tech-hub-skills install --global
+  npx tech-hub-skills init --enterprise
+  npx tech-hub-skills list
+
+${colors.bright}After Installation:${colors.reset}
+  Claude Code:    @orchestrator "Your project description"
+  GitHub Copilot: // Using AI Engineer approach for RAG pipeline
+  `);
+}
+
+// Parse arguments
+const args = process.argv.slice(2);
+const command = args[0];
+const options = {
+  global: args.includes("--global") || args.includes("-g"),
+  enterprise: args.includes("--enterprise") || args.includes("-E"),
+  copilot: args.includes("--copilot") || args.includes("-c"),
+  force: args.includes("--force") || args.includes("-f"),
+};
+
+switch (command) {
+  case "install":
+    printBanner();
+    install(options);
+    break;
+  case "init":
+    init(options);
+    break;
+  case "list":
+    list();
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    showHelp();
+    break;
+  case "version":
+  case "--version":
+  case "-v":
+    console.log(`tech-hub-skills v${VERSION}`);
+    break;
+  default:
+    showHelp();
+}