jackspace/claudeskillz/infrastructure-skill-builder

---
name: [infrastructure-component]-manager
description: Expert guidance for [component] management, provisioning, troubleshooting, and operations
license: MIT
tags: [infrastructure, [component], operations, troubleshooting]
---
 
# [Component] Manager
 
Expert knowledge for managing [component] infrastructure.
 
## Authentication & Access
 
### Access Methods

 
### Credentials & Configuration
- Where credentials are stored
- How to configure access
- Common authentication issues
 
## Architecture Overview
 
### Component Topology
- How components are organized
- Network topology
- Resource allocation
- Redundancy setup
 
### Key Resources
- Resource 1: Purpose and specs
- Resource 2: Purpose and specs
- Resource 3: Purpose and specs
 
## Common Operations
 
### Operation 1: [e.g., Create New Instance]

 
### Operation 2: [e.g., Update Configuration]

 
### Operation 3: [e.g., Scale Resources]

 
## Monitoring & Health Checks
 
### Check System Status

 
### Common Metrics
- Metric 1: What it means, normal range
- Metric 2: What it means, normal range
- Metric 3: What it means, normal range
 
## Troubleshooting
 
### Issue 1: [Common Problem]
**Symptoms**: What you observe
**Cause**: Why it happens
**Fix**: Step-by-step resolution

 
### Issue 2: [Another Problem]
**Symptoms**:
**Cause**:
**Fix**:

 
## Backup & Recovery
 
### Backup Procedures

 
### Recovery Procedures

 
## Security Best Practices
 
- Security practice 1
- Security practice 2
- Security practice 3
 
## Quick Reference
 
| Task | Command |
|------|---------|
| Task 1 | `command1` |
| Task 2 | `command2` |
| Task 3 | `command3` |
 
## Additional Resources
 
- Official documentation links
- Related skills
- External references

#!/bin/bash
# extract-from-runbook.sh - Convert runbook to skill
 
RUNBOOK_FILE="$1"
SKILL_NAME="$2"
 
if [ -z "$RUNBOOK_FILE" ] || [ -z "$SKILL_NAME" ]; then
    echo "Usage: $0 <runbook.md> <skill-name>"
    exit 1
fi
 
SKILL_DIR="skills/$SKILL_NAME"
mkdir -p "$SKILL_DIR"
 
# Extract sections from runbook
cat > "$SKILL_DIR/SKILL.md" << EOF
---
name: $SKILL_NAME
description: $(head -5 "$RUNBOOK_FILE" | grep -v "^#" | head -1 | xargs)
license: MIT
extracted-from: $RUNBOOK_FILE
---
 
# ${SKILL_NAME^}
 
$(cat "$RUNBOOK_FILE")
 
---
 
**Note**: This skill was auto-extracted from runbook documentation.
Review and refine before use.
EOF
 
echo "✓ Created skill: $SKILL_DIR/SKILL.md"
echo "Review and edit to add:"
echo "  - Metadata and tags"
echo "  - Troubleshooting section"
echo "  - Quick reference"
echo "  - Examples"

#!/bin/bash
# docker-compose-to-skill.sh - Extract skill from docker-compose.yaml
 
COMPOSE_FILE="${1:-docker-compose.yaml}"
PROJECT_NAME=$(basename $(pwd))
 
SKILL_DIR="skills/docker-$PROJECT_NAME"
mkdir -p "$SKILL_DIR"
 
# Extract services
SERVICES=$(yq eval '.services | keys | .[]' "$COMPOSE_FILE")
 
cat > "$SKILL_DIR/SKILL.md" << EOF
---
name: docker-$PROJECT_NAME
description: Docker Compose configuration and management for $PROJECT_NAME
license: MIT
---
 
# Docker $PROJECT_NAME
 
Manage Docker Compose stack for $PROJECT_NAME.
 
## Services
 
$(yq eval '.services | to_entries | .[] | "### " + .key + "\n" + (.value.image // "custom") + "\n"' "$COMPOSE_FILE")
 
## Quick Start
 
\`\`\`bash
# Start all services
docker-compose up -d
 
# Check status
docker-compose ps
 
# View logs
docker-compose logs -f
 
# Stop all services
docker-compose down
\`\`\`
 
## Service Details
 
### Ports
 
$(yq eval '.services | to_entries | .[] | select(.value.ports) | "- **" + .key + "**: " + (.value.ports | join(", "))' "$COMPOSE_FILE")
 
### Volumes
 
$(yq eval '.services | to_entries | .[] | select(.value.volumes) | "- **" + .key + "**: " + (.value.volumes | join(", "))' "$COMPOSE_FILE")
 
## Configuration
 
See \`$COMPOSE_FILE\` for full configuration.
 
## Common Operations
 
### Restart Service
 
\`\`\`bash
docker-compose restart SERVICE_NAME
\`\`\`
 
### Update Service
 
\`\`\`bash
docker-compose pull SERVICE_NAME
docker-compose up -d SERVICE_NAME
\`\`\`
 
### View Service Logs
 
\`\`\`bash
docker-compose logs -f SERVICE_NAME
\`\`\`
 
## Troubleshooting
 
### Service Won't Start
 
1. Check logs: \`docker-compose logs SERVICE_NAME\`
2. Verify ports not in use: \`netstat -tulpn | grep PORT\`
3. Check disk space: \`df -h\`
 
### Network Issues
 
\`\`\`bash
# Recreate network
docker-compose down
docker network prune
docker-compose up -d
\`\`\`
EOF
 
echo "✓ Created skill from docker-compose.yaml"

#!/bin/bash
# k8s-to-skill.sh - Extract skill from Kubernetes manifests
 
K8S_DIR="${1:-.}"
APP_NAME="${2:-$(basename $(pwd))}"
 
SKILL_DIR="skills/k8s-$APP_NAME"
mkdir -p "$SKILL_DIR"
 
cat > "$SKILL_DIR/SKILL.md" << EOF
---
name: k8s-$APP_NAME
description: Kubernetes deployment and management for $APP_NAME
license: MIT
---
 
# Kubernetes $APP_NAME
 
Manage Kubernetes resources for $APP_NAME.
 
## Resources
 
$(find "$K8S_DIR" -name "*.yaml" -o -name "*.yml" | while read file; do
    KIND=$(yq eval '.kind' "$file" 2>/dev/null)
    NAME=$(yq eval '.metadata.name' "$file" 2>/dev/null)
    echo "- **$KIND**: $NAME ($(basename $file))"
done)
 
## Deployment
 
### Apply All Resources
 
\`\`\`bash
kubectl apply -f $K8S_DIR/
\`\`\`
 
### Check Status
 
\`\`\`bash
# Pods
kubectl get pods -l app=$APP_NAME
 
# Services
kubectl get svc -l app=$APP_NAME
 
# Deployments
kubectl get deploy -l app=$APP_NAME
\`\`\`
 
## Common Operations
 
### Scale Deployment
 
\`\`\`bash
kubectl scale deployment $APP_NAME --replicas=3
\`\`\`
 
### Update Image
 
\`\`\`bash
kubectl set image deployment/$APP_NAME container=new-image:tag
\`\`\`
 
### View Logs
 
\`\`\`bash
kubectl logs -f deployment/$APP_NAME
\`\`\`
 
### Port Forward
 
\`\`\`bash
kubectl port-forward svc/$APP_NAME 8080:80
\`\`\`
 
## Troubleshooting
 
### Pod Not Starting
 
\`\`\`bash
# Check pod events
kubectl describe pod POD_NAME
 
# Check logs
kubectl logs POD_NAME
 
# Previous instance logs
kubectl logs POD_NAME --previous
\`\`\`
 
### Service Not Reachable
 
\`\`\`bash
# Check endpoints
kubectl get endpoints $APP_NAME
 
# Check service
kubectl describe svc $APP_NAME
 
# Test from another pod
kubectl run -it --rm debug --image=busybox --restart=Never -- wget -O- http://$APP_NAME
\`\`\`
 
## Quick Reference
 
| Task | Command |
|------|---------|
| Apply | \`kubectl apply -f $K8S_DIR/\` |
| Status | \`kubectl get all -l app=$APP_NAME\` |
| Logs | \`kubectl logs -f deployment/$APP_NAME\` |
| Scale | \`kubectl scale deployment $APP_NAME --replicas=N\` |
| Delete | \`kubectl delete -f $K8S_DIR/\` |
EOF
 
echo "✓ Created Kubernetes skill"

## SSH Access
 
| Host | IP | Purpose | Access |
|------|--------|---------|--------|
| node1 | 192.168.1.10 | Primary | `ssh node1` |
| node2 | 192.168.1.11 | Secondary | `ssh node2` |
| bastion | 203.0.113.5 | Jump host | `ssh -J bastion node1` |

## Service Ports
 
| Service | Internal | External | Protocol |
|---------|----------|----------|----------|
| Web | 8080 | 80 | HTTP |
| API | 3000 | 443 | HTTPS |
| DB | 5432 | - | TCP |

## Configuration Locations
 
### Application Config
-Path: `/etc/app/config.yaml`
-Format: YAML
-Requires restart: Yes
 
### Database Config
-Path: `/var/lib/postgres/postgresql.conf`
-Format: INI
-Requires restart: Yes

## Deployment Workflow
 
1.**Backup current state**
   ```bash
   ./backup.sh
   ```
 
2.**Pull latest code**
   ```bash
   git pull origin main
   ```
 
3.**Build application**
   ```bash
   docker build -t app:latest .
   ```
 
4.**Deploy**
   ```bash
   docker-compose up -d
   ```
 
5.**Verify**
   ```bash
   curl http://localhost/health
   ```