guardrails SKILL.md skillA

guardrails from ai-analyst-lab/ai-analyst is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add ai-analyst-lab/ai-analyst/guardrails@git:20260827.7ff2e25

Pins git:20260827.7ff2e25 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

ai-analyst-lab/ai-analyst

Path

.claude/skills/guardrails/SKILL.md

Versions recorded

1

Latest version

git:20260827.7ff2e25, committed Aug 27, 2026

Size

10,403 bytes

Repository stars

322

License

MIT

Ensure every success metric is paired with guardrail metrics and check for trade-offs before presenting improvements as wins. Guardrails protect against winning the metric game while losing the business game. Apply this skill whenever you define a metric, create a metric spec, document a KPI, report positive findings, present an improvement, analyze metric changes, investigate metric lifts, share good news about metrics, celebrate wins, or present results showing any metric increased. This…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Skill: Guardrails Awareness

## Purpose
Ensure that every success metric is paired with at least one guardrail metric, and that positive findings are checked for trade-offs before being presented as wins.

## When to Use
Apply this skill in two situations:
1. **When defining metrics** — after using the Metric Spec skill, check whether the metric has a guardrail pair
2. **When reporting positive findings** — before presenting any improvement, check whether a related guardrail metric degraded

## Instructions

### What Are Guardrails?

A **guardrail metric** is a metric you don't want to degrade while optimizing a success metric. Guardrails protect against winning the metric game while losing the business game.

```
SUCCESS METRIC:  The metric you're trying to improve
GUARDRAIL:       The metric that must not get worse
```

**The rule:** Never celebrate an improvement on a success metric without checking its guardrail(s). An improvement with a degraded guardrail is a trade-off, not a win.

### Common Guardrail Pairs

| Success Metric | Guardrail(s) | Why |
|---------------|-------------|-----|
…

Read the whole file at its exact version.

How to install

mdr add ai-analyst-lab/ai-analyst/guardrails@sha256:90cb098e0eee66d5

[![mdr](https://markdownregistry.com/badge/art_vai422rlqx3v6wrq.svg)](https://markdownregistry.com/a/art_vai422rlqx3v6wrq)

Versions

The registry has recorded 1 version of this file, committed on Aug 27, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_vai422rlqx3v6wrq
GET https://markdownregistry.com/api/v1/resolve?ref=ai-analyst-lab/ai-analyst/guardrails
GET https://markdownregistry.com/api/v1/blob/90cb098e0eee66d5db8f1faf9acefe2a675b7ed7b0e6967b5b2297c22874cb79

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ai-analyst-lab/ai-analyst

Every file in ai-analyst-lab/ai-analyst

Other files named guardrails

Browse by kind, by grade A, or by owner.