tech-hub-skills 1.0.0

package/LICENSE

@@ -0,0 +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.

package/README.md

@@ -0,0 +1,250 @@
+# Tech Hub Skills - Complete Role Documentation
+
+This document provides detailed information about all available roles and their skills.
+
+For installation instructions, see [../README.md](../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 (34 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 |
+
+### Architecture & Security Roles (15 skills)
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Security Architect** | 7 | PII, Threat Modeling, IAM, Secrets |
+| **System Design** | 8 | Architecture, Scalability, HA/DR, APIs |
+
+### Platform & Operations Roles (45 skills)
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Platform Engineer** | 6 | IDP, Self-Service, SLOs |
+| **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 (10+ skills)
+| Role | Skills | FocRoles us |
+|------|--------|-------|
+| **Code Review** | 5 | PR Automation, Quality Gates, Analytics |
+| **Compliance** | Integrated | SOC 2, GDPR, HIPAA, Audit Trails |
+| **Dashboard** | Integrated | Security, Compliance, DORA Metrics |
+
+### Product & Design Roles (6 skills)
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Product Designer** | 6 | Requirements, Research, UX, Brainstorming |
+
+### Cloud Platform Roles (12 skills)
+| Role | Skills | Focus |
+|------|--------|-------|
+| **Azure** | 12 | All Azure services |
+
+## 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 |
+| Security Architect | `sa-` | sa-01 to sa-07 |
+| System Design | `sd-` | sd-01 to sd-08 |
+| Platform Engineer | `pe-` | pe-01 to pe-06 |
+| 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 |
+| Code Review | `cr-` | cr-01 to cr-05 |
+| Product Designer | `pd-` | pd-01 to pd-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](../PUBLISHING.md).
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,241 @@
+#!/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');
+
+  if (fs.existsSync(skillsSrc)) {
+    print('  Copying skills...', 'yellow');
+    copyDir(skillsSrc, skillsDest);
+  }
+
+  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 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"');
+}
+
+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();
+}

package/bin/copilot.js

@@ -0,0 +1,182 @@
+/**
+ * GitHub Copilot integration utilities
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Generate GitHub Copilot instructions content
+ */
+function generateCopilotInstructions() {
+  return `# GitHub Copilot Instructions - Tech Hub Skills
+
+## Overview
+This workspace uses Tech Hub Skills - 110+ production-ready AI agent skills for software engineering.
+
+## Available Expert Roles
+
+### Orchestrator
+- **Focus**: Project coordination
+- **Skills**: Routes all
+
+### AI Engineer
+- **Focus**: LLMs, RAG, Agents
+- **Skills**: 8 specialized capabilities
+
+### Data Engineer
+- **Focus**: Pipelines, Lakehouse
+- **Skills**: 9 specialized capabilities
+
+### ML Engineer
+- **Focus**: Training, Serving, MLOps
+- **Skills**: 9 specialized capabilities
+
+### Data Scientist
+- **Focus**: Analytics, Modeling
+- **Skills**: 8 specialized capabilities
+
+### Security Architect
+- **Focus**: PII, IAM, Compliance
+- **Skills**: 7 specialized capabilities
+
+### System Design
+- **Focus**: Architecture, Scalability
+- **Skills**: 8 specialized capabilities
+
+### Platform Engineer
+- **Focus**: IDP, SLOs
+- **Skills**: 6 specialized capabilities
+
+### Data Governance
+- **Focus**: Catalog, Lineage, Quality
+- **Skills**: 6 specialized capabilities
+
+### DevOps
+- **Focus**: CI/CD, Containers, IaC
+- **Skills**: 9 specialized capabilities
+
+### MLOps
+- **Focus**: Experiments, Registry
+- **Skills**: 9 specialized capabilities
+
+### FinOps
+- **Focus**: Cost Optimization
+- **Skills**: 8 specialized capabilities
+
+### Azure
+- **Focus**: Azure Services
+- **Skills**: 12 specialized capabilities
+
+### Code Review
+- **Focus**: PR Automation, Quality Gates
+- **Skills**: 5 specialized capabilities
+
+### Product Designer
+- **Focus**: Requirements, UX
+- **Skills**: 6 specialized capabilities
+
+## How to Use These Skills
+
+When working on tasks, Copilot will reference these expert roles automatically. You can also:
+
+1. **Mention roles in comments**: \`// Using AI Engineer approach for RAG pipeline\`
+2. **Request specific expertise**: \`# Apply Security Architect best practices\`
+3. **Combine roles**: \`/* DevOps + FinOps: optimize CI/CD costs */\`
+
+## Coding Standards
+
+### Security (Security Architect)
+- Always validate and sanitize user inputs
+- Implement proper authentication and authorization
+- Never hardcode secrets or credentials
+- Use parameterized queries to prevent SQL injection
+- Apply principle of least privilege
+- Scan for PII before logging
+
+### AI/ML Development (AI Engineer)
+- Implement guardrails for LLM outputs
+- Use prompt templates for consistency
+- Monitor token usage and costs
+- Implement proper error handling for API calls
+- Cache embeddings when possible
+- Version control prompts and models
+
+### Data Engineering (Data Engineer)
+- Follow medallion architecture (bronze/silver/gold)
+- Implement idempotent pipelines
+- Add data quality checks at each stage
+- Use partitioning for large datasets
+- Implement proper error handling and retries
+- Document data lineage
+
+### DevOps Practices
+- Write infrastructure as code (IaC)
+- Implement CI/CD pipelines
+- Use containerization (Docker)
+- Apply GitOps principles
+- Implement monitoring and alerting
+- Automate testing at all levels
+
+## Project Structure
+
+Follow these conventions:
+- \`/src\` - Source code
+- \`/tests\` - Test files
+- \`/docs\` - Documentation
+- \`/infrastructure\` - IaC templates
+- \`/pipelines\` - CI/CD configurations
+- \`/.github\` - GitHub workflows and configurations
+
+## Quality Gates
+
+All code should:
+- ✓ Pass unit tests (>80% coverage)
+- ✓ Pass linting and formatting
+- ✓ Include error handling
+- ✓ Have inline documentation
+- ✓ Follow security best practices
+- ✓ Be optimized for performance
+
+## Tech Hub Skills Integration
+
+These instructions are generated from Tech Hub Skills package.
+To update: \`npx tech-hub-skills install --copilot\`
+
+---
+*Generated by Tech Hub Skills v1.0.0*
+`;
+}
+
+/**
+ * Install GitHub Copilot instructions to project
+ */
+function installCopilotInstructions(options = {}) {
+  const projectDir = process.cwd();
+  const githubDir = path.join(projectDir, '.github');
+  const copilotFile = path.join(githubDir, 'copilot-instructions.md');
+
+  // Check if file exists
+  if (fs.existsSync(copilotFile) && !options.force) {
+    console.log(`  ⚠️  Copilot instructions already exist at: ${copilotFile}`);
+    console.log(`      Use --force to overwrite`);
+    return false;
+  }
+
+  // Create .github directory if needed
+  if (!fs.existsSync(githubDir)) {
+    fs.mkdirSync(githubDir, { recursive: true });
+  }
+
+  // Write instructions
+  const content = generateCopilotInstructions();
+  fs.writeFileSync(copilotFile, content, 'utf8');
+
+  console.log(`  ✓ GitHub Copilot instructions created: ${copilotFile}`);
+  return true;
+}
+
+module.exports = {
+  generateCopilotInstructions,
+  installCopilotInstructions
+};