Incorporate suggestions from @coderabbitai

Author: arkadeepsen

plugins/sosreport/README.md

@@ -151,7 +151,7 @@ git clone https://github.com/openshift-eng/ai-helpers.git
 3. **Review findings**: Examine the interactive summary for critical issues and recommendations across all areas
 
 4. **Deep dive**: Ask follow-up questions about specific findings:
-   ```
+   ```bash
    Can you show me more details about the OOM killer events?
    What caused the httpd service to fail?
    ```

plugins/sosreport/commands/analyze.md

@@ -40,7 +40,7 @@ sosreport:analyze
   - Kernel parameters and resource limits
 
 ## Description
-The `sosreport:analyze` command performs comprehensive analysis of a sosreport archive (from https://github.com/sosreport/sos) to identify system issues, configuration problems, and potential causes of failures. It examines system logs, resource usage, network configuration, installed packages, and other diagnostic data collected by sosreport.
+The `sosreport:analyze` command performs comprehensive analysis of a sosreport archive (from <https://github.com/sosreport/sos>) to identify system issues, configuration problems, and potential causes of failures. It examines system logs, resource usage, network configuration, installed packages, and other diagnostic data collected by sosreport.
 
 By default, all analysis areas are executed. Use `--only` to run specific areas or `--skip` to exclude areas from analysis.
 
@@ -138,7 +138,7 @@ Perform resource analysis including:
 - Memory usage metrics and swap status
 - CPU count and load per CPU
 - Filesystems near capacity
-- Top CPU and memory consuming processes
+- Top CPU and memory-consuming processes
 - Resource-related issues and recommendations
 
 ### 5. Analyze Network Configuration
@@ -202,7 +202,7 @@ Perform system configuration analysis including:
    - Suggest next steps for troubleshooting
 
 3. **Format output**
-   ```
+   ```bash
    SOSREPORT ANALYSIS SUMMARY
    ==========================
 
@@ -264,49 +264,49 @@ Perform system configuration analysis including:
 ## Examples
 
 1. **Comprehensive analysis (default)**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport-server01-2024-01-15.tar.xz
    ```
 
    Extracts archive to `.work/sosreport-analyze/{timestamp}/` and performs comprehensive analysis using all skills (logs, resources, network, system-config).
 
 2. **Analyze only logs and network**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport-server01-2024-01-15.tar.xz --only logs,network
    ```
 
    Performs only log analysis and network analysis. Useful when investigating connectivity or service issues without needing full resource analysis.
 
 3. **Skip resource analysis**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport.tar.gz --skip resources
    ```
 
    Performs all analysis except resource analysis. Useful when you already know resource metrics and want to focus on configuration and logs.
 
 4. **Quick log-only analysis**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport.tar.xz --only logs
    ```
 
    Performs only log analysis. Fastest option for quickly identifying errors and critical events without analyzing configuration or resources.
 
 5. **Analyze extracted sosreport directory**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport-server01-2024-01-15/
    ```
 
    Analyzes an already extracted sosreport directory with comprehensive analysis.
 
 6. **Selective analysis on extracted directory**:
-   ```
+   ```bash
    /sosreport:analyze /tmp/sosreport-server01-2024-01-15/ --only system-config,network
    ```
 
    Analyzes only system configuration and network from an already extracted directory.
 
 7. **Follow-up investigation**:
-   ```
+   ```bash
    User: /sosreport:analyze /tmp/sosreport.tar.gz --only logs
    Agent: [Shows log analysis summary]
    User: Can you now analyze the resources as well?
@@ -344,5 +344,5 @@ Perform system configuration analysis including:
 - **System Configuration Analysis**: `plugins/sosreport/skills/system-config-analysis/SKILL.md` - Detailed guidance for analyzing packages, services, and security settings
 
 ### External Resources
-- Sosreport documentation: https://github.com/sosreport/sos
-- Red Hat sosreport guide: https://access.redhat.com/solutions/3592
+- Sosreport documentation: <https://github.com/sosreport/sos>
+- Red Hat sosreport guide: <https://access.redhat.com/solutions/3592>

plugins/sosreport/skills/logs-analysis/SKILL.md

@@ -225,7 +225,7 @@ Create a structured summary with the following information:
 
 The log analysis should produce:
 
-```
+```bash
 LOG ANALYSIS SUMMARY
 ====================
 

plugins/sosreport/skills/network-analysis/SKILL.md

@@ -316,7 +316,7 @@ Create a structured summary with the following sections:
 
 The network analysis should produce:
 
-```
+```bash
 NETWORK CONFIGURATION SUMMARY
 ==============================
 
@@ -476,7 +476,7 @@ $ grep "^tcp" sos_commands/networking/netstat_-neopa | awk '{print $6}' | sort |
 4. **Check MTU settings**: MTU mismatches can cause packet fragmentation issues
 5. **Correlate with logs**: Network errors in logs often explain configuration issues
 6. **Consider network topology**: Understand expected network layout
-7. **Check both IPv4 and IPv6**: Don't forget IPv6 if it's in use
+7. **Check both IPv4 and IPv6**: Be sure to check IPv6 if it's in use
 
 ## Common Network Patterns and Issues
 

plugins/sosreport/skills/resource-analysis/SKILL.md

@@ -288,7 +288,7 @@ Create a structured summary with the following sections:
 
 The resource analysis should produce:
 
-```
+```bash
 RESOURCE USAGE SUMMARY
 ======================
 

plugins/sosreport/skills/system-config-analysis/SKILL.md

@@ -336,7 +336,7 @@ Create a structured summary with the following sections:
 
 The system configuration analysis should produce:
 
-```
+```bash
 SYSTEM CONFIGURATION SUMMARY
 ============================