Closed loop analytics upgrade skill

Upgrade marketing, content, SEO/AEO/GEO, and revenue skills so changes are judged by platform analytics instead of vibes.

by ericosiu·MIT license·★ 3,615 Stars on the repo·GitHub ↗

Use now

Files of Closed loop analytics upgrade

ericosiu/main1 file shown
SKILL.md
Show the full text170 lines

Closed-Loop Analytics Upgrade

Principle

A workflow is not a closed loop until it checks whether the change worked and updates the playbook from that evidence.

For marketing skills, that means pulling analytics after the change window. Manual opinions are useful. Platform truth wins.

Core pattern

  1. Input: usage logs, recommendations, shipped changes, platform analytics, owner feedback, and cost/runtime data.
  2. AI action: compare baseline vs candidate, find repeatable signals, and propose a skill/playbook patch.
  3. Output: candidate patch to a prompt, skill, connector, brief template, scoring rubric, or next-action rule.
  4. Judgment: success rate, speed, cost, quality, human correction rate, and actual performance delta.
  5. Self-improvement: promote only if it beats baseline. Otherwise keep testing, rollback, or mark unproven.

Analytics by surface

X/Twitter

Track:

  • impressions
  • engagement rate
  • replies
  • reposts
  • bookmarks
  • profile clicks
  • follower delta
  • post length
  • hook style
  • proof number
  • CTA type
  • topic bucket

Use for:

  • title/hook formulas
  • longform structure
  • CTA patterns
  • post timing
  • topic scoring
YouTube

Track:

  • impressions
  • CTR
  • average view duration
  • retention curve
  • watch time
  • subscribers gained
  • comments
  • traffic source
  • title/thumbnail/hook metadata
  • video length and topic bucket

Use for:

  • title formulas
  • thumbnail rules
  • first-15-second hook
  • retention beats
  • chapter structure
  • Shorts cutdowns
  • repurposing guidance
SEO/AEO/GEO

Track:

  • GSC clicks, impressions, CTR, average position, query/page mix
  • GA4 sessions, engaged sessions, conversions, assisted leads
  • Ahrefs rankings, backlinks, traffic estimates, keyword movement
  • ClickFlow opportunities
  • AI-search / answer-engine visibility where available
  • CMS/page change log

Use for:

  • content refresh patterns
  • AEO/GEO opportunity scoring
  • query/page prioritization
  • internal linking and schema recommendations
  • rollback decisions
Revenue / outbound

Track:

  • HubSpot owner, lead, deal, and pipeline movement
  • Gong call language, objections, buying signals, and outcomes
  • Instantly/Smartlead positive replies, booked meetings, unsubscribes, spam risk
  • Metricool/LinkedIn post performance
  • GA4/HubSpot attribution

Use for:

  • outbound sequence patches
  • offer angle scoring
  • sales follow-up language
  • content-to-pipeline investment decisions

Required readback fields

Every promoted change needs:

  • change made
  • owner
  • baseline window
  • candidate window
  • source systems pulled
  • primary metric
  • secondary metrics
  • metric winner
  • caveats/confounders
  • decision: promote / keep testing / rollback / unproven
  • next patch
  • next readback date

Promotion rules

Promote when:

  • the candidate beats baseline on the primary metric, or
  • the candidate exposes a repeatable audience/customer signal, and
  • downside metrics are not meaningfully worse.

Do not promote when:

  • volume is too low
  • attribution is too dirty
  • the result is explained by seasonality or unrelated campaigns
  • the connector failed
  • only the author liked it

That last one is harsh but spiritually important.

Safety boundaries

Read-only analytics pulls are fine. External writes still require approval:

  • posting to X/LinkedIn/YouTube
  • publishing or editing CMS content
  • changing ad accounts, bids, budgets, targeting, or creative
  • mutating CRM/outbound tools
  • sending emails or DMs
  • changing credentials or production systems

Output template

# Readback: <skill/change>

## Verdict
Promote / keep testing / rollback / unproven

## Change tested
<what changed>

## Data pulled
| Source | Window | Status |
|---|---|---|

## Baseline vs candidate
| Metric | Baseline | Candidate | Delta | Interpretation |
|---|---:|---:|---:|---|

## Caveats
<confounders and missing data>

## Patch
<what changes in the skill/playbook>

## Next readback
<date + metric>
1---
2name: closed-loop-analytics-upgrade
3description: Upgrade marketing, content, SEO/AEO/GEO, and revenue skills so changes are judged by platform analytics instead of vibes. Use when applying closed-loop learning to X, YouTube, SEO, AEO/GEO, outbound, paid creative, or revenue workflows.
4---
5 
6# Closed-Loop Analytics Upgrade
7 
8## Principle
9 
10A workflow is not a closed loop until it checks whether the change worked and updates the playbook from that evidence.
11 
12For marketing skills, that means pulling analytics after the change window. Manual opinions are useful. Platform truth wins.
13 
14## Core pattern
15 
161. **Input**: usage logs, recommendations, shipped changes, platform analytics, owner feedback, and cost/runtime data.
172. **AI action**: compare baseline vs candidate, find repeatable signals, and propose a skill/playbook patch.
183. **Output**: candidate patch to a prompt, skill, connector, brief template, scoring rubric, or next-action rule.
194. **Judgment**: success rate, speed, cost, quality, human correction rate, and actual performance delta.
205. **Self-improvement**: promote only if it beats baseline. Otherwise keep testing, rollback, or mark unproven.
21 
22## Analytics by surface
23 
24### X/Twitter
25Track:
26- impressions
27- engagement rate
28- replies
29- reposts
30- bookmarks
31- profile clicks
32- follower delta
33- post length
34- hook style
35- proof number
36- CTA type
37- topic bucket
38 
39Use for:
40- title/hook formulas
41- longform structure
42- CTA patterns
43- post timing
44- topic scoring
45 
46### YouTube
47Track:
48- impressions
49- CTR
50- average view duration
51- retention curve
52- watch time
53- subscribers gained
54- comments
55- traffic source
56- title/thumbnail/hook metadata
57- video length and topic bucket
58 
59Use for:
60- title formulas
61- thumbnail rules
62- first-15-second hook
63- retention beats
64- chapter structure
65- Shorts cutdowns
66- repurposing guidance
67 
68### SEO/AEO/GEO
69Track:
70- GSC clicks, impressions, CTR, average position, query/page mix
71- GA4 sessions, engaged sessions, conversions, assisted leads
72- Ahrefs rankings, backlinks, traffic estimates, keyword movement
73- ClickFlow opportunities
74- AI-search / answer-engine visibility where available
75- CMS/page change log
76 
77Use for:
78- content refresh patterns
79- AEO/GEO opportunity scoring
80- query/page prioritization
81- internal linking and schema recommendations
82- rollback decisions
83 
84### Revenue / outbound
85Track:
86- HubSpot owner, lead, deal, and pipeline movement
87- Gong call language, objections, buying signals, and outcomes
88- Instantly/Smartlead positive replies, booked meetings, unsubscribes, spam risk
89- Metricool/LinkedIn post performance
90- GA4/HubSpot attribution
91 
92Use for:
93- outbound sequence patches
94- offer angle scoring
95- sales follow-up language
96- content-to-pipeline investment decisions
97 
98## Required readback fields
99 
100Every promoted change needs:
101 
102- change made
103- owner
104- baseline window
105- candidate window
106- source systems pulled
107- primary metric
108- secondary metrics
109- metric winner
110- caveats/confounders
111- decision: promote / keep testing / rollback / unproven
112- next patch
113- next readback date
114 
115## Promotion rules
116 
117Promote when:
118- the candidate beats baseline on the primary metric, or
119- the candidate exposes a repeatable audience/customer signal, and
120- downside metrics are not meaningfully worse.
121 
122Do not promote when:
123- volume is too low
124- attribution is too dirty
125- the result is explained by seasonality or unrelated campaigns
126- the connector failed
127- only the author liked it
128 
129That last one is harsh but spiritually important.
130 
131## Safety boundaries
132 
133Read-only analytics pulls are fine. External writes still require approval:
134 
135- posting to X/LinkedIn/YouTube
136- publishing or editing CMS content
137- changing ad accounts, bids, budgets, targeting, or creative
138- mutating CRM/outbound tools
139- sending emails or DMs
140- changing credentials or production systems
141 
142## Output template
143 
144```markdown
145# Readback: <skill/change>
146 
147## Verdict
148Promote / keep testing / rollback / unproven
149 
150## Change tested
151<what changed>
152 
153## Data pulled
154| Source | Window | Status |
155|---|---|---|
156 
157## Baseline vs candidate
158| Metric | Baseline | Candidate | Delta | Interpretation |
159|---|---:|---:|---:|---|
160 
161## Caveats
162<confounders and missing data>
163 
164## Patch
165<what changes in the skill/playbook>
166 
167## Next readback
168<date + metric>
169```
170 

Discussion

Alternatives