git clone https://github.com/ai-analyst-lab/ai-analyst
T=$(mktemp -d) && git clone --depth=1 https://github.com/ai-analyst-lab/ai-analyst "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/guardrails" ~/.claude/skills/ai-analyst-lab-ai-analyst-guardrails && rm -rf "$T"
.claude/skills/guardrails/skill.mdSkill: 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:
- When defining metrics — after using the Metric Spec skill, check whether the metric has a guardrail pair
- 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 |
|---|---|---|
| Conversion rate | Average order value, Return rate | Aggressive discounts inflate conversion but erode margin and invite returns |
| Signup rate | Activation rate, 7-day retention | Lowering the signup bar brings in unqualified users who churn immediately |
| Revenue per user | User satisfaction (NPS/CSAT), Support ticket volume | Monetization pressure degrades experience |
| Feature adoption | Core workflow completion, Session duration | Forcing feature usage may disrupt existing workflows |
| Time to complete (speed) | Error rate, Quality score | Rushing degrades accuracy |
| Cost reduction | Quality, Customer satisfaction | Cutting costs can degrade service |
| Engagement (DAU, sessions) | Revenue per user, Churn rate | Engagement tricks (notifications, dark patterns) don't translate to value |
| Support resolution time | Customer satisfaction, Reopen rate | Fast close ≠ good close if tickets reopen |
How to Apply
When Defining Metrics
After specifying a metric using the Metric Spec skill, add a guardrail section:
### Guardrails | Guardrail Metric | Acceptable Range | Check Frequency | |-----------------|-----------------|-----------------| | [guardrail 1] | [must stay above X / must not increase by >Y%] | [same cadence as success metric] | | [guardrail 2] | [threshold] | [cadence] |
Rules for selecting guardrails:
- At least one guardrail per success metric
- The guardrail should measure a different dimension of value (e.g., if success is quantity, guardrail is quality)
- The guardrail must be measurable with available data
- If no obvious guardrail exists, use customer satisfaction or support ticket volume as defaults
When Reporting Positive Findings
Before presenting any statement like "[metric] improved by X%," run this check:
GUARDRAIL CHECK □ Identified guardrail metric(s) for [success metric] □ Computed guardrail metric(s) over the same time period □ Compared guardrail to baseline / acceptable range □ Result: [CLEAR / TRADE-OFF / DEGRADED]
Verdicts:
| Verdict | Guardrail Status | How to Present |
|---|---|---|
| CLEAR | Guardrail stable or improved | Present the improvement as a win |
| TRADE-OFF | Guardrail slightly degraded (<10% relative) | Present the improvement AND the trade-off: "Conversion improved 15%, but AOV decreased 5%. Net revenue impact is +8%." |
| DEGRADED | Guardrail significantly degraded (>10% relative) | Do NOT present as a win. Present as: "Conversion improved 15%, but return rate doubled. The net impact may be negative — further investigation needed." |
Guardrail Escalation
When a guardrail is degraded:
- Quantify both sides — compute the success metric gain AND the guardrail loss in the same units (usually dollars or users)
- Compute net impact — is the gain larger than the loss?
- Flag uncertainty — guardrail degradation often has delayed effects (e.g., returns take weeks to materialize, churn shows up months later). Note this.
- Recommend investigation — "The conversion improvement looks positive, but the return rate increase warrants investigation before concluding this is a net win."
Output Format
When guardrails are checked, add this section to the analysis report:
## Guardrail Check | Success Metric | Change | Guardrail | Change | Verdict | |---------------|--------|-----------|--------|---------| | [metric] | +X% | [guardrail 1] | [no change / +Y% / -Z%] | CLEAR / TRADE-OFF / DEGRADED | | | | [guardrail 2] | [change] | [verdict] | **Net assessment:** [The improvement is real / The improvement comes with a trade-off / The improvement may be net negative]
Examples
Example 1: Clear Win
## Guardrail Check | Success Metric | Change | Guardrail | Change | Verdict | |---------------|--------|-----------|--------|---------| | Checkout conversion | +12% | Avg order value | +2% (stable) | CLEAR | | | | Return rate | -1% (improved) | CLEAR | **Net assessment:** The conversion improvement is a genuine win. Both guardrails are stable or improving.
Example 2: Trade-Off
## Guardrail Check | Success Metric | Change | Guardrail | Change | Verdict | |---------------|--------|-----------|--------|---------| | Signup rate | +25% | 7-day activation | -8% | TRADE-OFF | | | | 30-day retention | -3% (within normal range) | CLEAR | **Net assessment:** The signup rate improvement is partially offset by lower activation. The new signups are less qualified. Recommend segmenting the new signups to identify which acquisition channel is bringing lower-quality users.
Example 3: Degraded Guardrail
## Guardrail Check | Success Metric | Change | Guardrail | Change | Verdict | |---------------|--------|-----------|--------|---------| | Resolution time | -40% (faster) | Reopen rate | +85% | DEGRADED | | | | CSAT score | -22% | DEGRADED | **Net assessment:** The faster resolution time is coming at the cost of quality. Tickets are being closed prematurely and reopened, and customer satisfaction has dropped significantly. This is NOT a net improvement. Recommend reverting the process change and investigating sustainable ways to reduce resolution time.
Anti-Patterns
- Never report a success metric improvement without checking guardrails — a 20% conversion lift with a 30% return rate increase is not a win
- Never define a metric without at least one guardrail — every metric can be gamed; guardrails prevent it
- Never dismiss a small guardrail degradation — small degradations compound and may have delayed effects (churn shows up months later)
- Never use the same metric as both success and guardrail — they must measure different dimensions of value
- Never skip the net impact calculation — "conversion up, returns up" is not actionable without knowing which effect is larger