Skill: Close-the-Loop
SkillDev toolsEnsure every analysis that includes a recommendation ends with a clear, actionable follow-up plan. CRITICAL RULE - Only use this skill AFTER a specific recommendation has been made. Use this skill at the end of ANY analysis that produces a recommendation, action item, suggested fix, proposed investment, or conclusion that says "we should do X." This skill is CRITICAL for turning analytical insights into actual business outcomes — without it, recommendations get forgotten and never evaluated. Apply this skill whenever you complete an analysis with findings that suggest a course of action, finish a root cause investigation that identifies a fix, complete an opportunity sizing that recommends an investment, produce a deck or report with recommendations, or any time the analysis concludes with "we should..." or "I recommend...". Even if the user doesn't explicitly ask for follow-up tracking, add the close-the-loop checklist automatically — it's a mandatory step for any analysis with recommendations. DO NOT USE this skill for exploratory questions like "should we investigate this?", "what's causing this pattern?", "is this worth looking into?" — these are pre-recommendation questions. Wait until the recommendation is clear, THEN apply close-the-loop. Skip for pure exploratory analyses with no recommendations or action items.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Skill: Close-the-Loop skill
What this skill tells your AI
The instructions your AI receives, as published by ai-analyst-lab/ai-analyst in .claude/skills/close-the-loop/SKILL.md and read by ahel’s review.
Purpose
Ensure every analysis that includes a recommendation ends with a clear follow-up plan — who decides, what metric tracks success, when to check back, and what to do if the expected outcome doesn't materialize.
When to Use
Triggering Test (use this decision tree)
Ask yourself: "Has a specific recommendation or action item been made?"
- YES → Apply Close-the-Loop
- NO → Skip (even if a decision is needed, wait until the recommendation is formulated)
Apply this skill when:
- The analysis concludes with a recommendation ("we should do X")
- Root cause investigation identifies a fix ("deploy the hotfix", "roll back v3.2")
- Opportunity sizing recommends an investment ("invest 2 eng-months to recover $2.1M")
- Multiple options are presented and a decision is needed ("Option A vs B vs C")
- The analysis outputs action items that need tracking
Skip this skill when:
- Pure exploratory analysis with no recommendations ("interesting pattern, still investigating")
- User is asking whether to investigate ("should we look into this?" — this is premature, no recommendation yet)
- Questions about causality ("is this correlation or causation?" — wait until you recommend a course of action)
- Descriptive reports with no proposed actions ("here's what happened last quarter")
- Data quality assessments (unless they recommend fixes)
- Answering factual questions ("what was revenue last month?")
Instructions
The Close-the-Loop Checklist
Append this checklist to the end of every analysis report or presentation that includes a recommendation:
## Close the Loop
### Decision
- **Recommendation:** [What the analysis recommends]
- **Decision maker:** [Who will approve/reject this — name or role]
- **Decision deadline:** [When this needs to be decided by]
- **Decision made:** [ ] Yes / [ ] No / [ ] Deferred
- **Decision outcome:** [What was actually decided — fill in after]
### Success Tracking
- **Success metric:** [What metric will tell us the recommendation worked?]
- **Current baseline:** [What is the metric today?]
- **Target:** [What value do we expect if the recommendation works?]
- **Measurement window:** [How long after implementation before we evaluate?]
- **Data source:** [Where to pull the metric]
### Follow-Up
- **Check-in date:** [When to evaluate whether the recommendation worked]
- **Owner:** [Who is responsible for the follow-up check]
- **If successful:** [What's the next step — scale it, document it, move to next priority]
- **If unsuccessful:** [What's the fallback — investigate further, try alternative, accept the status quo]
- **If inconclusive:** [What additional data or time is needed before deciding]
### Analysis Provenance
- **Analysis date:** [When this analysis was completed]
- **Analyst:** [Who produced it]
- **Key assumptions:** [1-3 assumptions the recommendation depends on]
- **Confidence level:** [HIGH / MEDIUM / LOW]
- **What would change the recommendation:** [Under what conditions should we revisit]
Why Each Field Matters
| Field | Why It Matters |
|---|---|
| Decision maker | Without an owner, recommendations float. Someone must say yes or no. |
| Decision deadline | Without a deadline, the decision gets deferred indefinitely. Most analytical insights have a shelf life. |
| Success metric | Without a success metric, you can't tell if the recommendation worked. |
| Current baseline | Without a baseline, you can't measure improvement. "Conversion improved" means nothing without "from what?" |
| Target | Without a target, any change looks like success. Set a bar. |
| Measurement window | Some changes take weeks to show results. Define when to check. |
| Check-in date | The follow-up is the most commonly skipped step. Set a date. |
| If unsuccessful | Pre-commit to the fallback so you don't rationalize a failed recommendation after the fact. |
Filling in the Checklist
What you can fill in (as the analyst):
- Recommendation (from the analysis)
- Success metric, baseline, and target (from the data)
- Measurement window (based on typical lag for this metric)
- Key assumptions and confidence level (from the analysis)
- What would change the recommendation (from sensitivity analysis, if available)
What the user must fill in (prompt them):
- Decision maker
- Decision deadline
- Owner for follow-up
- Check-in date
When the user must fill in fields, prompt them explicitly:
This analysis recommends [X]. To close the loop, I need to know:
- Who will decide whether to proceed? (decision maker)
- By when does this need to be decided? (deadline)
- Who will check whether it worked? (follow-up owner)
Handling Multiple Recommendation Options
When the analysis presents multiple mutually exclusive options (Option A, B, or C), structure the checklist to handle conditional success tracking:
## Close the Loop
### Decision
- **Recommendation:** Three options presented:
- **Option A:** [Description + key metrics]
- **Option B:** [Description + key metrics]
- **Option C:** [Description + key metrics]
- **Decision maker:** [Who will choose between options]
- **Decision deadline:** [When to decide]
- **Decision made:** [ ] Option A / [ ] Option B / [ ] Option C / [ ] Hybrid / [ ] Deferred
- **Decision outcome:** _[pending]_
### Success Tracking
#### If Option A is selected
- **Success metric:** [metric specific to Option A]
- **Current baseline:** [value]
- **Target:** [value]
- **Measurement window:** [timeframe]
#### If Option B is selected
- **Success metric:** [metric specific to Option B]
- **Current baseline:** [value]
- **Target:** [value]
- **Measurement window:** [timeframe]
[Repeat for each option]
### Follow-Up
- **Check-in date:** [varies by option selected]
- **Owner:** [same across options or varies]
- **If successful (Option A):** [what to do next]
- **If successful (Option B):** [what to do next]
- **If unsuccessful (any option):** [fallback plan that works regardless of choice]
This ensures each option has clear, measurable success criteria before the decision is made.
Connecting to Opportunity Sizing
If the analysis used the Opportunity Sizer agent, connect the success tracking to the sizing model:
### Success Tracking (from Opportunity Sizing)
- **Success metric:** [same as the primary metric in the sizing model]
- **Current baseline:** [from the base case computation]
- **Target (base case):** [from the base case impact]
- **Target (pessimistic):** [from the pessimistic scenario]
- **Break-even threshold:** [from the break-even analysis — "if improvement < X%, not worth it"]
- **Measurement window:** [long enough to observe the expected impact]
This directly links the "was it worth it?" question to the sizing model's assumptions.
Integration with Other Skills
Close-the-Loop works best when combined with these other analytical skills:
-
Before Close-the-Loop:
- Triangulation: Validate findings before committing to a follow-up plan. If the analysis hasn't been cross-checked, note it in the confidence level.
- Stress Test: Pressure-test the recommendation for methodological flaws before setting success metrics.
-
During Close-the-Loop:
- Guardrails Awareness: If the recommendation has positive expected impact, check for potential negative side effects. Include guardrail metrics in Success Tracking.
-
After Close-the-Loop:
- Archive Analysis: Save the analysis with its close-the-loop plan to the knowledge system for future reference.
When applying Close-the-Loop, check whether these skills have been applied. If not, flag it in the Analysis Provenance confidence level (e.g., "MEDIUM — findings not yet triangulated").
Examples
Example 1: Bug Fix Recommendation
## Close the Loop
### Decision
- **Recommendation:** Deploy hotfix v2.3.1 to resolve iOS payment processing regression
- **Decision maker:** Engineering lead (Priya)
- **Decision deadline:** End of this sprint (Feb 21)
- **Decision made:** [ ] Yes / [ ] No / [ ] Deferred
- **Decision outcome:** _[pending]_
### Success Tracking
- **Success metric:** Weekly support ticket volume (payment category, iOS)
- **Current baseline:** 89 tickets/week (anomaly period average)
- **Target:** <40 tickets/week (pre-anomaly baseline)
- **Measurement window:** 2 weeks after hotfix deploy
- **Data source:** {schema}.support_tickets, filtered to category='payment' AND device='iOS'
### Follow-Up
- **Check-in date:** 2 weeks after deploy
- **Owner:** _[to be assigned]_
- **If successful:** Document the incident, update monitoring to catch similar regressions earlier
- **If unsuccessful:** Investigate whether the root cause is actually v2.3.0 or a deeper issue; escalate to senior engineering
- **If inconclusive:** Extend measurement window to 4 weeks; check for confounding events
### Analysis Provenance
- **Analysis date:** 2026-02-14
- **Analyst:** AI Product Analyst
- **Key assumptions:** (1) The v2.3.0 release is the sole cause of the ticket spike, (2) The hotfix fully resolves the payment processing issue, (3) No other changes affect payment tickets during the measurement window
- **Confidence level:** HIGH
- **What would change the recommendation:** If the v2.3.0 → ticket spike correlation breaks down when controlling for a third variable, or if the hotfix was already deployed and tickets didn't recover
Example 2: Strategic Recommendation
## Close the Loop
### Decision
- **Recommendation:** Invest in mobile checkout optimization (projected $480K annual revenue impact)
- **Decision maker:** VP Product
- **Decision deadline:** Q2 planning (Mar 15)
- **Decision made:** [ ] Yes / [ ] No / [ ] Deferred
- **Decision outcome:** _[pending]_
### Success Tracking
- **Success metric:** Mobile checkout conversion rate
- **Current baseline:** 2.1%
- **Target (base case):** 3.4% (+62%)
- **Target (pessimistic):** 2.7% (+29%)
- **Break-even threshold:** 2.3% (+10%) — below this, the investment ROI is negative
- **Measurement window:** 8 weeks after changes ship (4 weeks ramp + 4 weeks measurement)
- **Data source:** {schema}.events (checkout_viewed → purchase_completed, device='mobile')
### Follow-Up
- **Check-in date:** 8 weeks after ship
- **Owner:** _[to be assigned]_
- **If successful:** Expand optimization to tablet; investigate next-largest conversion bottleneck
- **If unsuccessful:** Conduct user research on mobile checkout friction; consider A/B testing specific elements
- **If inconclusive:** Extend to 12 weeks; segment by device model and OS version for more signal
### Analysis Provenance
- **Analysis date:** 2026-02-14
- **Analyst:** AI Product Analyst
- **Key assumptions:** (1) Mobile conversion gap is due to UX friction, not user intent differences, (2) 30% of the gap is closeable through checkout optimization, (3) $47 AOV remains stable
- **Confidence level:** MEDIUM
- **What would change the recommendation:** If mobile users have fundamentally different purchase intent (not just friction), or if the AOV for mobile is significantly lower than desktop, the revenue projection would change
Anti-Patterns
- Never end an analysis with just a recommendation — a recommendation without follow-up tracking is a suggestion that gets forgotten
- Never skip the baseline — "improve conversion" is meaningless without "from 2.1%"
- Never set a target without a measurement window — conversion could improve in 2 days or 2 months; define when to check
- Never leave the decision maker blank — if no one owns the decision, no one makes it
- Never skip the "if unsuccessful" plan — pre-committing to a fallback prevents sunk-cost rationalization
- Never set the check-in date too far out — if the measurement window is 2 weeks, the check-in should be 2-3 weeks after ship, not 6 months later
Signals
- GitHub stars
- 298
- Forks
- 137
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
close-the-loop- Source
- github.com/ai-analyst-lab/ai-analyst