@elizaos/skills 2.0.0-alpha.3

package/skills/security-culture-index/skills/interpreting-culture-index/scripts/extract_pdf.py

@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#     "opencv-python-headless>=4.10.0,<5.0",
+#     "numpy>=2.0.0,<3.0",
+#     "pdf2image>=1.17.0,<2.0",
+#     "pytesseract>=0.3.10,<1.0",
+# ]
+# ///
+"""Extract Culture Index profile data from PDF to JSON.
+
+Simple wrapper script for Claude to run when extracting data from Culture Index PDFs.
+Uses OpenCV-based extraction (100% accuracy, no API keys needed).
+
+Usage:
+    uv run extract_pdf.py <input.pdf> [output.json]
+    uv run extract_pdf.py --verify <input.pdf>
+
+Examples:
+    # Extract and print to stdout
+    uv run extract_pdf.py profile.pdf
+
+    # Extract with verification summary (recommended)
+    uv run extract_pdf.py --verify profile.pdf
+
+    # Extract and save to file
+    uv run extract_pdf.py profile.pdf profile.json
+
+Output Format:
+    {
+      "name": "Person Name",
+      "archetype": "Architect",
+      "survey": {
+        "eu": 21,
+        "arrow": 2.3,
+        "a": [5, 2.7],      // [absolute, relative_to_arrow]
+        "b": [0, -2.3],
+        "c": [1, -1.3],
+        "d": [3, 0.7],
+        "logic": [5, null],
+        "ingenuity": [2, null]
+      },
+      "job": { ... },
+      "analysis": {
+        "energy_utilization": 148,
+        "status": "stress"
+      }
+    }
+
+System Requirements:
+    macOS:
+        brew install poppler tesseract
+
+    Ubuntu/Debian:
+        apt-get install poppler-utils tesseract-ocr
+"""
+
+from __future__ import annotations
+
+import argparse
+import io
+import json
+import sys
+from contextlib import redirect_stdout
+from pathlib import Path
+
+# Add scripts directory to path for culture_index import
+scripts_dir = Path(__file__).parent
+sys.path.insert(0, str(scripts_dir))
+
+from culture_index.extract import process_pdf  # noqa: E402
+
+
+def render_chart(chart: dict, title: str) -> list[str]:
+    """Render a chart as ASCII art matching PDF layout.
+
+    Args:
+        chart: Chart data with traits as [absolute, relative] arrays.
+        title: Chart title (e.g., "Survey Traits")
+
+    Returns:
+        List of lines to print.
+    """
+    lines = []
+    eu = chart.get("eu", "?")
+    arrow = chart.get("arrow", 0)
+
+    lines.append(f"{title} (EU={eu})")
+    lines.append("        0   1   2   3   4   5   6   7   8   9  10")
+
+    # Primary traits
+    for trait in ["a", "b", "c", "d"]:
+        values = chart.get(trait, [0, 0])
+        score = int(values[0]) if values else 0
+        # Build the line with dot at correct position
+        line = f"    {trait.upper()}   "
+        for i in range(11):
+            if i == score:
+                line += "●   "
+            else:
+                line += "    "
+        line += f"[{score}]"
+        lines.append(line)
+
+    # Secondary traits (L, I)
+    for trait, key in [("L", "logic"), ("I", "ingenuity")]:
+        values = chart.get(key, [0, None])
+        score = int(values[0]) if values else 0
+        line = f"    {trait}   "
+        for i in range(11):
+            if i == score:
+                line += "●   "
+            else:
+                line += "    "
+        line += f"[{score}]"
+        lines.append(line)
+
+    # Arrow indicator
+    arrow_pos = int(round(arrow))
+    arrow_line = "        "
+    for i in range(11):
+        if i == arrow_pos:
+            arrow_line += "↑   "
+        else:
+            arrow_line += "    "
+    arrow_line += f"arrow ({arrow})"
+    lines.append(arrow_line)
+
+    return lines
+
+
+def print_verification_summary(data: dict) -> None:
+    """Print a verification summary with ASCII charts to stderr.
+
+    Args:
+        data: Extracted JSON data.
+    """
+    print("\n" + "=" * 60, file=sys.stderr)
+    print("VERIFICATION SUMMARY - Compare with PDF", file=sys.stderr)
+    print("=" * 60, file=sys.stderr)
+    print(f"Name: {data.get('name', 'Unknown')}", file=sys.stderr)
+    print(f"Pattern: {data.get('archetype', 'Unknown')}", file=sys.stderr)
+    print(file=sys.stderr)
+
+    # Survey chart
+    survey = data.get("survey", {})
+    for line in render_chart(survey, "Survey Traits"):
+        print(line, file=sys.stderr)
+    print(file=sys.stderr)
+
+    # Job chart
+    job = data.get("job", {})
+    for line in render_chart(job, "Job Behaviors"):
+        print(line, file=sys.stderr)
+    print(file=sys.stderr)
+
+    # Energy utilization
+    analysis = data.get("analysis", {})
+    eu_pct = analysis.get("energy_utilization", 0)
+    eu_status = analysis.get("status", "unknown")
+    status_indicator = {
+        "healthy": "✓",
+        "stress": "⚠️ STRESS",
+        "frustration": "⚠️ FRUSTRATION",
+    }.get(eu_status, "?")
+    print(f"Energy Utilization: {eu_pct}% ({status_indicator})", file=sys.stderr)
+    print("=" * 60 + "\n", file=sys.stderr)
+
+
+def main() -> int:
+    """Main entry point."""
+    parser = argparse.ArgumentParser(
+        description="Extract Culture Index profile data from PDF to JSON.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  uv run extract_pdf.py profile.pdf              # Print JSON to stdout
+  uv run extract_pdf.py --verify profile.pdf     # Print JSON + verification summary
+  uv run extract_pdf.py profile.pdf out.json     # Save to file
+        """,
+    )
+    parser.add_argument("pdf", type=Path, help="Input PDF file path")
+    parser.add_argument("output", type=Path, nargs="?", help="Output JSON file path (optional)")
+    parser.add_argument(
+        "--verify",
+        "-v",
+        action="store_true",
+        help="Show verification summary for spot-checking (recommended)",
+    )
+
+    args = parser.parse_args()
+
+    # Capture stdout if we need to parse the JSON for verification
+    if args.verify and not args.output:
+        # Capture the JSON output
+        captured = io.StringIO()
+        with redirect_stdout(captured):
+            result = process_pdf(args.pdf, args.output)
+
+        if result.success:
+            json_output = captured.getvalue()
+            print(json_output)  # Print JSON to stdout
+
+            # Parse and show verification
+            try:
+                data = json.loads(json_output)
+                print_verification_summary(data)
+            except json.JSONDecodeError:
+                print("Warning: Could not parse JSON for verification", file=sys.stderr)
+            return 0
+        else:
+            print(f"Error: {result.error}", file=sys.stderr)
+            return 1
+    else:
+        # Normal operation
+        result = process_pdf(args.pdf, args.output)
+
+        if result.success:
+            if args.output:
+                print(f"Extracted: {result.output_path}", file=sys.stderr)
+
+                # If --verify and output file, read and verify
+                if args.verify:
+                    try:
+                        data = json.loads(args.output.read_text())
+                        print_verification_summary(data)
+                    except (json.JSONDecodeError, FileNotFoundError):
+                        print("Warning: Could not read output for verification", file=sys.stderr)
+            return 0
+        else:
+            print(f"Error: {result.error}", file=sys.stderr)
+            return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/security-culture-index/skills/interpreting-culture-index/scripts/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "culture-index-scripts"
+version = "1.0.0"
+description = "Dependencies for Culture Index PDF extraction scripts"
+requires-python = ">=3.11"
+dependencies = [
+    "opencv-python-headless>=4.10.0,<5.0",
+    "numpy>=2.0.0,<3.0",
+    "pdf2image>=1.17.0,<2.0",
+    "pytesseract>=0.3.10,<1.0",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]

package/skills/security-culture-index/skills/interpreting-culture-index/templates/burnout-report.md

@@ -0,0 +1,113 @@
+# Burnout Detection Report Template
+
+Copy and fill this template when analyzing burnout risk using Culture Index Survey vs Job comparison.
+
+---
+
+## Burnout Risk Assessment: [Name]
+
+**Date:** [Date]
+**Data Source:** [PDF/JSON]
+**Pattern:** [Archetype]
+
+### Energy Utilization
+
+| Metric | Value |
+|--------|-------|
+| Survey EU | [value] |
+| Job EU | [value] |
+| **Utilization** | **[Job/Survey × 100]%** |
+
+### Status Classification
+
+| Range | Status | This Person |
+|-------|--------|-------------|
+| 70-130% | Healthy | [ ] |
+| >130% | **STRESS** (burnout risk) | [ ] |
+| <70% | **FRUSTRATION** (flight risk) | [ ] |
+
+**Current Status:** [Healthy/Stress/Frustration]
+
+### Arrow Movement
+
+| Graph | Arrow Position | Delta |
+|-------|----------------|-------|
+| Survey | [value] | - |
+| Job | [value] | [±X] |
+
+**Interpretation:** [Arrow moved right = stress / Arrow moved left = frustration / No movement = stable]
+
+### Trait Modification Analysis
+
+| Trait | Survey | Job | Change | Interpretation |
+|-------|--------|-----|--------|----------------|
+| A | [pos from arrow] | [pos from arrow] | [±X] | [meaning] |
+| B | [pos from arrow] | [pos from arrow] | [±X] | [meaning] |
+| C | [pos from arrow] | [pos from arrow] | [±X] | [meaning] |
+| D | [pos from arrow] | [pos from arrow] | [±X] | [meaning] |
+
+### Most Significant Modifications
+
+1. **[Trait]:** [Survey pos] → [Job pos] ([interpretation])
+2. **[Trait]:** [Survey pos] → [Job pos] ([interpretation])
+
+### Red Flags Detected
+
+| Signal | Present | Details |
+|--------|---------|---------|
+| EU 0-10 (avoidant) | [Y/N] | [details] |
+| All dots flipped sides | [Y/N] | [details] |
+| D raised significantly | [Y/N] | [details] |
+| Arrow shifted >2 positions | [Y/N] | [details] |
+| Utilization >150% | [Y/N] | [details] |
+| Utilization <50% | [Y/N] | [details] |
+
+### Risk Assessment
+
+| Factor | Finding | Risk Level |
+|--------|---------|------------|
+| EU Utilization | [%] | [Low/Medium/High/Critical] |
+| Trait Modifications | [summary] | [Low/Medium/High/Critical] |
+| Arrow Movement | [summary] | [Low/Medium/High/Critical] |
+| **Overall Risk** | - | **[Low/Medium/High/Critical]** |
+
+### Root Cause Hypothesis
+
+Based on the modification pattern, likely causes include:
+
+1. **[Cause 1]:** [explanation based on specific trait changes]
+2. **[Cause 2]:** [explanation based on specific trait changes]
+
+### Recommended Actions
+
+**Immediate (if High/Critical):**
+- [ ] [Immediate action]
+- [ ] [Immediate action]
+
+**Short-term:**
+- [ ] [Short-term action]
+- [ ] [Short-term action]
+
+**Ongoing:**
+- [ ] [Ongoing monitoring action]
+
+### Questions to Explore
+
+1. [Question to ask in 1:1 based on modifications]
+2. [Question to ask in 1:1 based on modifications]
+3. [Question to ask in 1:1 based on modifications]
+
+### Resurvey Recommendation
+
+| Current Risk | Resurvey In |
+|--------------|-------------|
+| Low | 6 months |
+| Medium | 3 months |
+| High | 1-2 months |
+| Critical | After intervention |
+
+**Next resurvey:** [Date]
+
+---
+
+*Burnout analysis based on Survey vs Job comparison. Survey = hardwired traits; Job = adaptive behaviors. Sustained behavior modification drains energy. This assessment is one input - combine with direct conversation and observation.*

package/skills/security-culture-index/skills/interpreting-culture-index/templates/comparison-report.md

@@ -0,0 +1,103 @@
+# Profile Comparison Report Template
+
+Copy and fill this template when comparing two Culture Index profiles for compatibility analysis.
+
+---
+
+## Profile Comparison: [Person A] & [Person B]
+
+**Date:** [Date]
+**Relationship:** [Peers / Manager-Report / Cross-functional / etc.]
+
+### Profile Overview
+
+| Trait | Person A | Person B | Gap | Same Side? |
+|-------|----------|----------|-----|------------|
+| Pattern | [Archetype] | [Archetype] | - | - |
+| A | [±X from arrow] | [±X from arrow] | [diff] | [Y/N] |
+| B | [±X from arrow] | [±X from arrow] | [diff] | [Y/N] |
+| C | [±X from arrow] | [±X from arrow] | [diff] | [Y/N] |
+| D | [±X from arrow] | [±X from arrow] | [diff] | [Y/N] |
+| L | [absolute] | [absolute] | [diff] | - |
+| I | [absolute] | [absolute] | [diff] | - |
+
+### Compatibility Assessment
+
+| Factor | Score | Notes |
+|--------|-------|-------|
+| Overall Pattern Match | [High/Medium/Low] | [patterns similar or complementary?] |
+| A Alignment | [High/Medium/Low] | [collaboration vs independence] |
+| B Alignment | [High/Medium/Low] | [social energy match] |
+| C Alignment | [High/Medium/Low] | [pace match] |
+| D Alignment | [High/Medium/Low] | [detail orientation match] |
+
+### Primary Friction Points
+
+| Trait Gap | Person A Tendency | Person B Tendency | Friction |
+|-----------|-------------------|-------------------|----------|
+| [Trait] | [behavior] | [behavior] | [friction description] |
+| [Trait] | [behavior] | [behavior] | [friction description] |
+
+### Primary Alignment Points
+
+| Trait | Person A | Person B | Alignment |
+|-------|----------|----------|-----------|
+| [Trait] | [behavior] | [behavior] | [why compatible] |
+| [Trait] | [behavior] | [behavior] | [why compatible] |
+
+### How They Likely See Each Other
+
+**Person A sees Person B as:**
+- [Perception based on trait gap]
+- [Perception based on trait gap]
+
+**Person B sees Person A as:**
+- [Perception based on trait gap]
+- [Perception based on trait gap]
+
+### Collaboration Recommendations
+
+**For [Person A]:**
+1. [Adjustment to make when working with Person B]
+2. [Adjustment to make when working with Person B]
+
+**For [Person B]:**
+1. [Adjustment to make when working with Person A]
+2. [Adjustment to make when working with Person A]
+
+**Process/Environment Changes:**
+1. [Process change to reduce friction]
+2. [Process change to reduce friction]
+
+### Optimal Working Arrangement
+
+| Aspect | Recommendation | Why |
+|--------|----------------|-----|
+| Meeting frequency | [recommendation] | [based on C and B traits] |
+| Communication channel | [recommendation] | [based on B traits] |
+| Decision-making | [recommendation] | [based on A traits] |
+| Quality review | [recommendation] | [based on D traits] |
+
+### Complementary Strengths
+
+When paired effectively, this combination can:
+1. [Complementary strength 1]
+2. [Complementary strength 2]
+
+### Watch Areas
+
+When stressed or misaligned:
+1. [Potential breakdown area]
+2. [Potential breakdown area]
+
+### Summary
+
+**Overall Compatibility:** [High/Medium/Low]
+
+**Key Takeaway:** [1-2 sentence summary of the relationship dynamics]
+
+**Action Required:** [None/Process adjustment/Active management/Intervention]
+
+---
+
+*Compatibility analysis based on trait gap assessment. Opposite traits create friction but also complementary strengths. Same-side traits create easy rapport but potential blind spots.*

package/skills/security-culture-index/skills/interpreting-culture-index/templates/hiring-profile.md

@@ -0,0 +1,127 @@
+# Hiring Profile Template
+
+Copy and fill this template when defining the ideal Culture Index profile for a role.
+
+---
+
+## Hiring Profile: [Role Title]
+
+**Date Created:** [Date]
+**Created By:** [Name]
+**Department:** [Department]
+
+### Role Context
+
+| Factor | Detail |
+|--------|--------|
+| Reports to | [Manager name and pattern, if known] |
+| Team size | [Current team size] |
+| Business stage | [Growth / Consolidation / Turnaround / Stability] |
+| Remote/Office | [Remote / Hybrid / Office] |
+
+### Role Requirements Analysis
+
+**Role-Fit Questions:**
+
+| Question | Answer | Trait Implication |
+|----------|--------|-------------------|
+| Is this role more macro or micro? | [answer] | A: [High/Low/Norm] |
+| Is this role about people or problems? | [answer] | B: [High/Low/Norm] |
+| How much repetition is in this role? | [answer] | C: [High/Low/Norm] |
+| Does this role require strict process? | [answer] | D: [High/Low/Norm] |
+| Does success require analytical detachment? | [answer] | L: [range or any] |
+| Does success require novel problem-solving? | [answer] | I: [range or any] |
+
+### Ideal Profile
+
+| Trait | Position | Confidence | Rationale |
+|-------|----------|------------|-----------|
+| A (Autonomy) | [High/Low/Norm] | [H/M/L] | [why this position] |
+| B (Social) | [High/Low/Norm] | [H/M/L] | [why this position] |
+| C (Pace) | [High/Low/Norm] | [H/M/L] | [why this position] |
+| D (Conformity) | [High/Low/Norm] | [H/M/L] | [why this position] |
+| L (Logic) | [range or any] | [H/M/L] | [why this range] |
+| I (Ingenuity) | [range or any] | [H/M/L] | [why this range] |
+
+**Target Pattern:** [Pattern name]
+
+### Acceptable Variations
+
+| Pattern | Acceptability | Notes |
+|---------|---------------|-------|
+| [Ideal pattern] | Ideal | [notes] |
+| [Alternative 1] | Acceptable | [why acceptable] |
+| [Alternative 2] | Acceptable | [why acceptable] |
+| [Alternative 3] | Marginal | [trade-offs] |
+
+### Acceptable Trait Ranges
+
+| Trait | Ideal | Acceptable | Hard No |
+|-------|-------|------------|---------|
+| A | [pos] | [range] | [extremes to avoid] |
+| B | [pos] | [range] | [extremes to avoid] |
+| C | [pos] | [range] | [extremes to avoid] |
+| D | [pos] | [range] | [extremes to avoid] |
+
+### Red Flags (Do Not Hire)
+
+| Red Flag | Why Problematic for This Role |
+|----------|-------------------------------|
+| [Pattern or trait] | [specific reason] |
+| [Pattern or trait] | [specific reason] |
+| [Pattern or trait] | [specific reason] |
+
+### Team Fit Considerations
+
+**Current team composition:**
+- Gas (High A): [count] people
+- Brake (High D): [count] people
+- Glue (High B): [count] people
+
+**This hire should add:**
+- [ ] Gas (if lacking growth drivers)
+- [ ] Brake (if lacking quality control)
+- [ ] Glue (if lacking culture builders)
+- [ ] Diversity (if team is too homogeneous)
+
+### Manager Compatibility
+
+Manager: [Name] - [Pattern]
+
+| Manager Trait | Ideal Hire Trait | Compatibility Notes |
+|---------------|------------------|---------------------|
+| [Manager A] | [Ideal A] | [alignment or friction] |
+| [Manager B] | [Ideal B] | [alignment or friction] |
+| [Manager C] | [Ideal C] | [alignment or friction] |
+| [Manager D] | [Ideal D] | [alignment or friction] |
+
+### Interview Focus Areas
+
+Based on ideal profile, explore these areas during interviews:
+
+1. **[Trait]:** [What to probe for]
+2. **[Trait]:** [What to probe for]
+3. **[Trait]:** [What to probe for]
+
+### Using This Profile
+
+**With predicted traits (from interview transcript):**
+- Compare predicted profile to this template
+- Note alignment and concerns
+- Flag any red flag traits
+
+**With actual CI survey (after offer signed):**
+- Compare actual survey to predictions
+- Verify fit against this profile
+- Identify onboarding adjustments if needed
+
+### Approval
+
+| Role | Name | Date |
+|------|------|------|
+| Hiring Manager | [Name] | [Date] |
+| HR/People Ops | [Name] | [Date] |
+
+---
+
+*Hiring profiles define ideal traits, not rigid requirements. CI is one input - combine with skills assessment, experience review, and culture interview.*

package/skills/security-culture-index/skills/interpreting-culture-index/templates/individual-report.md

@@ -0,0 +1,85 @@
+# Individual Profile Report Template
+
+Copy and fill this template when reporting on an individual's Culture Index profile.
+
+---
+
+## [Name] - [Archetype/Pattern]
+
+**Date:** [Date]
+**Data Source:** [PDF/JSON]
+
+### Profile Summary
+
+| Trait | Position | Distance from Arrow | Interpretation |
+|-------|----------|---------------------|----------------|
+| A (Autonomy) | [value] | [±X centiles] | [High/Low/Normative] |
+| B (Social) | [value] | [±X centiles] | [High/Low/Normative] |
+| C (Pace) | [value] | [±X centiles] | [High/Low/Normative] |
+| D (Conformity) | [value] | [±X centiles] | [High/Low/Normative] |
+| L (Logic) | [value] | n/a | [High/Normative/Low - absolute] |
+| I (Ingenuity) | [value] | n/a | [High/Moderate/Low - absolute] |
+
+**Arrow Position:** [value]
+**EU (Survey):** [value]
+**EU (Job):** [value] *(if available)*
+
+### Leading Traits
+
+1. **[Trait]** at [±X centiles] - [interpretation]
+2. **[Trait]** at [±X centiles] - [interpretation]
+3. **[Trait]** at [±X centiles] - [interpretation]
+
+### Strengths
+
+1. [Strength based on leading traits]
+2. [Strength based on leading traits]
+3. [Strength based on leading traits]
+
+### Challenges / Development Areas
+
+1. [Challenge based on leading traits]
+2. [Challenge based on leading traits]
+
+### Energy Status
+
+| Metric | Value | Status |
+|--------|-------|--------|
+| Survey EU | [value] | - |
+| Job EU | [value] | - |
+| Utilization | [Job/Survey × 100]% | [Healthy/Stress/Frustration] |
+
+*(If Job behaviors unavailable, note "Single survey only - no utilization comparison available")*
+
+### Survey vs Job Comparison
+
+*(Complete this section only if both graphs are available)*
+
+| Trait | Survey | Job | Change | Interpretation |
+|-------|--------|-----|--------|----------------|
+| A | [pos] | [pos] | [diff] | [meaning] |
+| B | [pos] | [pos] | [diff] | [meaning] |
+| C | [pos] | [pos] | [diff] | [meaning] |
+| D | [pos] | [pos] | [diff] | [meaning] |
+
+**Arrow Movement:** [Survey arrow] → [Job arrow]
+
+### Recommendations
+
+1. [Actionable recommendation based on profile]
+2. [Actionable recommendation based on profile]
+
+### Communication Preferences
+
+- **Best way to communicate:** [based on traits]
+- **Feedback approach:** [based on A and D]
+- **Meeting style:** [based on B and C]
+
+### Notes
+
+- [Any additional observations]
+- Culture Index is one data point - combine with skills, experience, and performance data
+
+---
+
+*Interpretation follows Culture Index methodology. All trait positions are relative to the population mean (arrow). No trait is inherently "good" or "bad" - fit depends on role and context.*