🎓 Professor Hudak - OTC Awesome LLM Assistant

Professor Hudak is your intelligent guide to discovering and using the 100+ battle-tested AI assets in the otc-awesome-llm repository. Named after a distinguished computer scientist, it helps users navigate prompts, chatmodes, instructions, and more with personalized recommendations.

Features

• 🔍 Asset Discovery: Search 100+ prompts, chatmodes, instructions, and collections
• 📅 Recent Updates: Track new features, improvements, and releases
• 🤝 Contribution Guidance: Step-by-step help for creating new assets
• 💡 Task Recommendations: Get personalized suggestions based on your current work
• 📊 Repository Insights: Understand the 3-track model and repository structure

Installation

Prerequisites

• Claude Code CLI installed
• Node.js 18+ installed
• Access to the otc-awesome-llm repository

Install Steps

1. Clone or navigate to the otc-awesome-llm repository:

   cd /path/to/otc-awesome-llm
   

2. Install Professor Hudak:

   # From the repository root
   cd claude-code/plugins/professor-hudak
   npm install
   
   # Register with Claude Code
   claude plugins install .
   

3. Verify installation:

   claude plugins list
   # Should show "professor-hudak" in the list
   

Usage

Available Commands

/ph-discover [query] - Discover Assets

Search and filter the repository's assets by type, tags, or keywords.

/ph-discover kubernetes
/ph-discover terraform review
/ph-discover chatmode
/ph-discover tag:ops

/ph-recent [days] - Recent Updates

Show recent additions and changes to the repository.

/ph-recent        # Last 7 days (default)
/ph-recent 14     # Last 14 days
/ph-recent 30     # Last month

/ph-contribute [type] - Contribution Guide

Get step-by-step guidance for contributing new assets.

/ph-contribute              # Interactive mode
/ph-contribute prompt       # Create a new prompt
/ph-contribute chatmode     # Create a new chatmode
/ph-contribute instruction  # Create a new instruction

/ph-recommend [task] - Task Recommendations

Get asset recommendations based on what you're working on.

/ph-recommend debug kubernetes pod crash
/ph-recommend plan terraform azure infrastructure
/ph-recommend write ansible playbook for nginx
/ph-recommend improve code review process

/ph-help [topic] - Help & Overview

Get help and learn about the repository.

/ph-help                    # General overview
/ph-help getting-started    # First steps
/ph-help asset-types        # Understanding different assets
/ph-help dr-zero           # Learn about autonomous mode

Examples

Finding Kubernetes Assets

User: /ph-discover kubernetes

Professor Hudak: Found 8 Kubernetes-related assets:

📝 **Prompts** (3):
• k8s-pod-debug - Debug failing pods (⭐ Quality: 92%)
• k8s-deployment-rollout - Safe deployment strategies
• k8s-resource-optimization - Resource limit tuning

💬 **Chatmodes** (1):
• k8s-operations-assistant - Long-running K8s helper

📚 **Collections** (1):
• ops-k8s-core - Complete K8s operations bundle

Getting Task Recommendations

User: /ph-recommend debug kubernetes pod that keeps crashing

Professor Hudak: Based on your task, here are my recommendations:

🎯 **Perfect Match**:
• **Prompt**: `k8s-pod-debug` (⭐ Quality: 92%)
  - Specifically designed for debugging failing pods
  - Handles CrashLoopBackOff, ImagePullBackOff, etc.

🛠️ **For Extended Debugging**:
• **Chatmode**: `k8s-operations-assistant`
  - Long-running K8s troubleshooting session

📚 **Complete Bundle**:
• **Collection**: `ops-k8s-core`
  - Includes k8s-pod-debug prompt
  - K8s operations instructions

Contributing a New Asset

User: /ph-contribute prompt

Professor Hudak: Let's create a new prompt! Here's your guide:

1. **Create your prompt file**:
   Path: shared/prompts/your-prompt-name.prompt.md

2. **Use this template**: [YAML frontmatter template provided]

3. **Validation checklist**:
   ✓ Run: npm run validate
   ✓ Test: npm test
   ✓ Quality: npm run quality-check

4. **Commit format**:
   feat(prompts): add your-prompt-name for X functionality

How It Works

Architecture

Professor Hudak consists of:

1. Commands (/commands/): User-facing slash commands
2. Agents (/agents/): Core logic and intelligence
3. Source Modules (/src/):
   • asset-indexer.js: Indexes and searches repository assets
   • update-tracker.js: Tracks git history and changes
   • recommendation-engine.js: Provides intelligent suggestions
   • utils/execFileNoThrow.js: Safe command execution

Integration Points

• MCP Server: Connects to shared/mcp/server.js for real-time asset data
• Git History: Analyzes commits and releases for recent updates
• Quality Scores: Integrates with quality report for asset rankings
• Dr. Zero: Suggests appropriate autonomous modes

Security

• Uses execFile instead of exec to prevent command injection
• All user inputs are sanitized before use
• Read-only access to repository data
• No file modifications without explicit user action

Development

Running Tests

cd claude-code/plugins/professor-hudak
npm test

Building

npm run build

Contributing

1. Follow the otc-awesome-llm contribution guidelines
2. Add tests for new features
3. Update documentation
4. Use conventional commits

Troubleshooting

Common Issues

MCP Server Connection Failed

• Ensure you're in the otc-awesome-llm repository
• Check that Node.js 18+ is installed
• Verify MCP server file exists at shared/mcp/server.js

No Assets Found

• Run npm run build in repository root to generate metadata
• Check file permissions for asset directories
• Ensure git is installed and repository is initialized

Git History Not Available

• Verify you're in a git repository
• Check git is in PATH
• Ensure you have read permissions for git history

License

MIT - Same as otc-awesome-llm repository

Support

• Report issues: https://github.com/optum-tech-compute/otc-awesome-llm/issues
• Documentation: https://github.com/optum-tech-compute/otc-awesome-llm/docs

---

Made with 🎓 by the OTC Awesome LLM team