AGENT SKILL

model-qa

Use when an org role acts as model QA specialist and must independently audit an ML or statistical model: replication, calibration, drift, fairness, governance. Rates findings by severity with PSI, SHAP and champion-challenger tests; audits models others built.

License 许可
Apache-2.0
所属仓库
monoes/monomind
最近更新
2026-11-10
Stars
★ 23
Forks
2

01 前言 Front Matter

name
model-qa
tags
[ "ai-ml", "engineering", "audit", "evaluation" ]
tools
[ "monograph_query", "monograph_context", "monograph_impact" ]
source
https://github.com/monoes/monomind
license
Apache-2.0
description
Use when an org role acts as model QA specialist and must independently audit an ML or statistical model: replication, calibration, drift, fairness, governance. Rates findings by severity with PSI, SHAP and champion-challenger tests; audits models others built.

03 SKILL.md 正文

Model QA Specialist — Best Practices

Focus

Independently audits ML/statistical models end-to-end — documentation, data, replication, calibration, and fairness — to certify whether a model is sound before or during production use.

Best practices

  • Never audit a model you built yourself — independence is the whole point; findings from a self-review are structurally suspect.
  • Require full reproducibility: every analysis must run from raw data to final output via a versioned, self-contained script — no manual steps.
  • Replicate the model from documented methodology and compare outputs against the original (parameter deltas, score distributions) before trusting either.
  • Test calibration explicitly, not just discrimination — a model can rank correctly (good AUC) while its predicted probabilities are badly miscalibrated.
  • Check feature and population stability over time (PSI or similar) — a model that was sound at training time can silently drift out of validity.
  • Rate every finding by severity (High/Medium/Low/Info) with quantified business impact — "this seems off" is not a finding.
  • Audit fairness across protected/segment groups explicitly, not just aggregate performance.
  • Verify governance basics — model inventory, approval trail, monitoring plan — exist and are current, before diving into the statistics.

Common pitfalls

  • Accepting in-sample or training metrics as sufficient evidence of production soundness, skipping out-of-time validation.
  • Declaring "the model is wrong" without quantifying the impact or proposing a remediation.
  • Checking aggregate performance only, missing a segment where the model fails badly but is diluted in the overall number.
  • Treating a passed discrimination test (AUC/Gini) as sufficient without also checking calibration — the two measure different things and both can fail independently.
  • Skipping documentation/governance review because the statistics "look fine" — an undocumented or unapproved model is a finding regardless of accuracy.

Tools & techniques

  • Population Stability Index (PSI) per feature and per period to quantify distribution drift.
  • Hosmer-Lemeshow test, Brier score, and reliability diagrams for calibration validation.
  • SHAP global (beeswarm/importance) and local (waterfall) analysis to verify learned relationships match documented rationale.
  • Partial Dependence Plots (including 2D interaction plots) to check for expected monotonic/directional relationships and detect learned interaction effects.
  • Champion-challenger benchmarking with statistical significance testing (e.g. DeLong test for AUC differences) before recommending a model swap.

04 同仓库更多 Skills

monoes
monoes/monomind

zk-steward

Org role guidance for a ZK steward: engineer zero-knowledge proof systems with circuit design, SNARK vs STARK choice and security review. This is zero-knowledge cryptography, not Zettelkasten note-taking.

★ 23
monoes
monoes/monomind

writing-plans

Use when you have a spec or requirements for a multi-step coding task and must write an implementation plan before touching code. Produces bite-sized TDD tasks with exact file paths, code and commands for an engineer with zero context.

内容创作者写作与文案
★ 23
monoes
monoes/monomind

write-spec

Write a feature spec or PRD from a problem statement or feature idea. Use when turning a vague idea or user request into a structured document, scoping a feature with goals and non-goals, defining success metrics and acceptance criteria, or breaking a big ask into a phased spec.

产品经理
★ 23
monoes
monoes/monomind

write-query

Write optimized SQL for your dialect with best practices. Use when translating a natural-language data need into SQL, building a multi-CTE query with joins and aggregations, optimizing a query against a large partitioned table, or getting dialect-specific syntax for Snowflake, BigQuery, Postgres, etc.

数据分析师
★ 23
monoes
monoes/monomind

workflow-automation

Org role guidance for workflow automation: build and maintain CI/CD definitions in GitHub Actions or equivalent: triggers, jobs, matrices, caching. Covers path filters, dependency caching, parallel jobs, timeouts and fail-fast ordering.

运维与部署Skill与智能体开发
★ 23
monoes
monoes/monomind

workflow-architect

Org role guidance for a workflow architect: map full workflow trees for systems, user journeys and agents, covering every branch and failure. Covers discovering workflows from code, handoff contracts, timeouts, recovery paths and observable state.

Skill与智能体开发
★ 23