AD Assessment Document Generator Skill

Generate professional, executive-ready DOCX assessment reports from Active Directory health data.

"The document should look like it came from a Big 4 consulting firm, not a script output."

When to Use This Skill

Design Philosophy

Professional Standards

Color Palette (Severity-Based)

Typography System

Font Family: Arial (universal compatibility)

Title:           28pt, Bold, #1E3A5F (Navy)
Heading 1:       18pt, Bold, #1E3A5F
Heading 2:       14pt, Bold, #374151 (Gray-700)
Heading 3:       12pt, Bold, #4B5563 (Gray-600)
Body:            11pt, Regular, #111827 (Gray-900)
Caption:         9pt, Regular, #6B7280 (Gray-500)
Code:            10pt, Consolas, #1F2937, Background #F3F4F6

Document Structure

Required Sections (In Order)

1. Cover Page

   • Logo placeholder (centered)
   • Document title: "Active Directory Health Assessment"
   • Subtitle: "Security and Configuration Report"
   • Client domain name (prominent)
   • Assessment date
   • Confidentiality notice

2. Executive Summary (1 page max)

   • Health score gauge (0-100)
   • Risk distribution chart (text-based)
   • Top 3-5 critical findings (bullet summary)
   • Immediate action items

3. Environment Overview

   • Forest/Domain properties table
   • Domain Controllers status table
   • FSMO roles health table
   • Sites and subnets summary

4. Findings by Category

   • Grouped by: Critical → High → Medium → Low
   • Each finding uses the Finding Card template
   • Include affected objects count

5. Detailed Remediation

   • Step-by-step instructions
   • PowerShell commands (properly formatted)
   • Validation steps
   • External documentation links

6. Appendices

   • Full affected objects lists
   • Technical metrics raw data
   • Glossary of terms

Data Validation Rules

CRITICAL: Never Output These

// Before generating any field, validate:
if (value === undefined || value === null || value === '') {
  return 'No disponible';  // Or appropriate default
}
if (typeof value === 'object' && !Array.isArray(value)) {
  return JSON.stringify(value);  // Or extract specific field
}
if (value === 'undefined ms' || value === 'undefined') {
  return 'N/A';
}

Health Score Calculation

// Score should NEVER be 0 if systems are operational
function calculateHealthScore(findings) {
  let score = 100;
  
  findings.forEach(f => {
    switch(f.severity) {
      case 'CRITICAL': score -= 15; break;
      case 'HIGH': score -= 10; break;
      case 'MEDIUM': score -= 5; break;
      case 'LOW': score -= 2; break;
    }
  });
  
  return Math.max(0, score);  // Floor at 0
}

Quick Reference: docx-js Patterns

Severity Badge Cell

function createSeverityCell(severity) {
  const colors = {
    'CRITICAL': { fill: 'FEE2E2', text: '991B1B' },
    'HIGH': { fill: 'FEF3C7', text: '92400E' },
    'MEDIUM': { fill: 'FEF9C3', text: '854D0E' },
    'LOW': { fill: 'DBEAFE', text: '1E40AF' }
  };
  const c = colors[severity] || colors['LOW'];
  
  return new TableCell({
    shading: { fill: c.fill, type: ShadingType.CLEAR },
    children: [new Paragraph({
      alignment: AlignmentType.CENTER,
      children: [new TextRun({ 
        text: severity, 
        bold: true, 
        color: c.text,
        size: 20 
      })]
    })]
  });
}

Code Block Paragraph

function createCodeBlock(code) {
  return new Paragraph({
    shading: { fill: 'F3F4F6', type: ShadingType.CLEAR },
    spacing: { before: 120, after: 120 },
    indent: { left: 360, right: 360 },
    children: [new TextRun({
      text: code,
      font: 'Consolas',
      size: 20,
      color: '1F2937'
    })]
  });
}

Reference Files

Load these for specific implementation details:

• 📄 Document Structure - Complete section templates with docx-js code
• 🎨 Design System - Full color palette, typography, spacing
• 📊 Table Templates - Pre-built table layouts for each section
• 🔍 Finding Cards - Individual finding presentation format

Anti-Patterns to Avoid

Version History