Org Health Diagnostic

What Is Org Health Diagnostic?

Org Health Diagnostic is a cross-functional organizational health check tool designed to provide a comprehensive, data-driven assessment of a company's health. Developed as a Claude Code skill, it aggregates and analyzes signals from all major C-suite roles, scoring the organization across eight critical dimensions. Each dimension receives a traffic-light rating (green/yellow/red), enabling leaders to instantly identify strengths, weaknesses, and at-risk functions. The tool is particularly valuable for board reviews, pre-emptive risk identification, and ongoing organizational diagnostics, leveraging real benchmarks and drill-down recommendations for actionable insights.

Why Use Org Health Diagnostic?

Modern organizations operate in increasingly complex environments, where isolated metrics or siloed departmental snapshots fail to capture the full picture of organizational health. Board members, executives, and operational leads require a holistic view to make informed decisions, prioritize interventions, and allocate resources effectively. Org Health Diagnostic fills this gap by synthesizing inputs from Finance, Revenue, Product, Engineering, People, Operations, Security, and Market functions into a unified dashboard. The traffic-light scoring system distills complex data into an instantly understandable format, while supporting deeper investigation and tailored recommendations.

Using Org Health Diagnostic can help organizations:

• Surface hidden risks or underperforming areas before they escalate
• Establish a common language for discussing organizational health at the executive and board levels
• Benchmark current status against industry standards
• Guide strategic planning and resource allocation
• Track progress over time with consistent scoring

How to Get Started

Getting started with Org Health Diagnostic is straightforward. The tool is implemented in Python and available as open source under the MIT License. It supports both command-line and integration-based workflows.

Installation

Clone the repository from GitHub:

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills/c-level-advisor/org-health-diagnostic

Install dependencies as needed (typically Python 3.8+):

pip install -r requirements.txt

Running the Diagnostic

You can launch the interactive health scoring tool using the provided script:

python scripts/health_scorer.py

This guided CLI will prompt you for key metrics across all eight dimensions. Upon completion, you'll receive a color-coded dashboard summarizing your organization's health status.

Example CLI Workflow

$ python scripts/health_scorer.py
Enter months of runway: 9
Current quarter revenue growth (%): 5
Product delivery velocity (story points/sprint): 40
Engineering on-call incidents last month: 3
... [additional prompts]

For integration with other systems or for programmatic access, output can be generated in raw JSON format:

python scripts/health_scorer.py --json

You can also interact via natural language, for example:

/health [paste your key metrics or answer prompts]
/health:dimension financial

Key Features

Eight Dimensions of Health

Org Health Diagnostic evaluates the following areas, each mapped to C-suite responsibilities:

1. Financial Health (CFO): Funding runway, burn rate, liquidity
2. Revenue Health (CRO): Growth, pipeline, churn
3. Product Health (CPO): Roadmap progress, customer adoption
4. Engineering Health (CTO): Delivery velocity, incidents
5. People Health (CHRO): Retention, engagement
6. Operations Health (COO): Efficiency, process adherence
7. Security Health (CISO): Incident frequency, audit status
8. Market Health (CMO): Share, NPS, competitive position

Traffic-Light Scoring

Each dimension is scored on a green (healthy), yellow (watch), or red (at risk) scale, based on real-world benchmarks. This allows for rapid assessment and prioritization.

Drill-Down Recommendations

Beyond summary scores, the tool provides tailored recommendations for each dimension, supporting root-cause analysis and targeted action planning.

Flexible Input Modes

Org Health Diagnostic accommodates both numerical metrics and qualitative assessments, supporting CLI, JSON, and natural language input modes.

Open Source and Extensible

Released under the MIT License, the tool can be customized or extended to fit organization-specific benchmarks or dimensions.

Best Practices

• Prepare Accurate Data: Ensure that the metrics inputted for each dimension are up-to-date and validated to maximize diagnostic accuracy.
• Include Diverse Perspectives: Gather input from relevant C-suite stakeholders to prevent blind spots and ensure cross-functional representation.
• Use Regularly: Incorporate Org Health Diagnostic into quarterly reviews or board meetings to monitor trends and spot regression or improvement over time.
• Act on Recommendations: Treat traffic-light warnings as action items. Use drill-down suggestions to guide deeper investigations and corrective measures.
• Integrate With Dashboards: For advanced users, incorporate JSON outputs into existing BI or dashboarding tools for longitudinal tracking.

Important Notes

• Org Health Diagnostic provides guidance based on industry benchmarks, but should not replace detailed departmental audits or expert consultation where needed.
• The tool is designed for cross-functional assessment; single-dimension usage may limit its effectiveness.
• Scoring thresholds can be tuned based on organizational context or industry, enhancing relevance.
• As an open-source project, community contributions are welcome. Review the repository for the latest updates and submit issues or pull requests as needed.
• Always protect sensitive company data when integrating or sharing outputs of the tool.

For more details, visit the GitHub repository.