Fairness Audit

by do-ops885

skill

Validates True Positive Rate and False Positive Rate gaps across demographics using AgentDB metrics

Skill Details

Repository Files

1 file in this skill directory


name: fairness-audit description: Validates True Positive Rate and False Positive Rate gaps across demographics using AgentDB metrics license: MIT compatibility: opencode metadata: audience: developers workflow: clinical-pipeline

What I do

I validate that the risk assessment meets fairness standards by checking TPR (True Positive Rate) and FPR (False Positive Rate) gaps across demographic groups. I ensure the model performs equitably regardless of skin tone.

When to use me

Use this when:

  • Risk assessment is complete and you need fairness validation
  • You need to verify TPR/FPR gaps are within acceptable thresholds
  • You're ensuring the model doesn't exhibit demographic bias

Key Concepts

  • TPR Gap: Difference in true positive rates across groups
  • FPR Gap: Difference in false positive rates across groups
  • Fairness Thresholds: Maximum acceptable gaps (typically 0.1)
  • fairness_validated: State flag after audit complete

Source Files

  • services/agentDB.ts: Fairness metrics storage
  • services/goap.ts: Fairness validation action

Code Patterns

  • Query AgentDB for demographic performance metrics
  • Calculate TPR and FPR gaps between groups
  • Fail validation if gaps exceed thresholds

Operational Constraints

  • TPR and FPR gaps MUST be within acceptable thresholds
  • If fairness validation fails, diagnosis is not web-verified
  • Must maintain demographic parity in performance metrics

Related Skills

Attack Tree Construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

skill

Grafana Dashboards

Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.

skill

Matplotlib

Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.

skill

Scientific Visualization

Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.

skill

Seaborn

Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.

skill

Shap

Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Query Writing

For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Scientific Visualization

Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.

skill

Skill Information

Category:Skill
License:MIT
Last Updated:1/14/2026