Permission Setup Review
python scripts/_wildcard_placeholder.py is an optional setup helper for the X Founder Operations skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
X Founder Operations
Systematic X (Twitter) account operations for founders, indie developers, and tech professionals.
Who This Is For
- Founders: Building a brand, generating leads, fundraising, hiring, and establishing thought leadership while running a company
- Indie developers: Growing an audience around products, sharing the build journey, converting followers to users
- Tech professionals: Building a personal brand, establishing domain expertise, expanding professional network
This skill adapts to your specific role, goals, and growth stage through configurable profiles and goals.
Core Philosophy
Three Pillars
- Authenticity First: Your persona is a focused version of who you really are, not a character you play. People follow people, not brands.
- Value Before Promotion: 80% of content should deliver genuine value. Trust is built slowly and lost quickly.
- Data-Driven Evolution: Every post generates data. Every data point informs the next decision. Strategy evolves through empirical results, not gut feeling.
Data Integrity (Non-Negotiable)
- NEVER fabricate tweet content, metrics, or URLs
- NEVER guess or hallucinate to fill data gaps
- ALWAYS validate data through the validation workflow
- ALWAYS mark missing data as
null, never assume values
When API calls fail: STOP, report the failure honestly, and never proceed with fabricated data. See Data Validation Script for the full validation workflow.
Quick Start
1. Set Up Your Profile
Copy and customize the config templates:
config/profile.example.json → config/profile.json
config/goals.example.json → config/goals.json
config/watchlist.example.json → config/watchlist.json
config/content-calendar.example.json → config/content-calendar.json
Fill in your handle, role, product info, voice attributes, and target audience. See Profile Optimization for guidance on optimizing your X profile.
2. Define Your Goals
In config/goals.json, set:
- Primary objective (brand building, lead gen, fundraising, hiring, thought leadership)
- Growth stage (early, growth, established, authority)
- Monthly and quarterly targets
- Content mix ratios
See Growth Benchmarks for realistic targets by growth stage.
3. Build Your Watchlist
In config/watchlist.json, identify:
- 5-10 core circle accounts for daily engagement
- 3-5 competitor accounts to monitor
- Industry and media accounts to track
- Relevant X Communities to join
4. Start the Daily Loop
Follow the Operations Methodology PDCA loop:
Morning: Scan → Plan → Warm Up (30-45 min)
Daytime: Create → Post → Engage (throughout the day)
Evening: Check metrics → Reflect → Plan tomorrow (15-20 min)
Daily Operations Loop
The core operating system. See Methodology for full details.
Morning Phase: Plan + Warm Up
- Scan: Check overnight mentions, core circle activity, trending topics
- Plan: Select today's content from calendar, prepare tweet drafts
- Warm up: Spend 15-20 min replying to 10-15 accounts from your core circle (this primes the algorithm before your own posts)
Execution Phase: Create + Post + Engage
- Post 2-3 tweets at optimal windows (see Cron Schedule), spaced 2-3 hours apart
- Stay active 30-60 min after each post — reply to every comment in the first hour
- Engage with core circle and community 2-3 times throughout the day
- No external links in main tweet body — always put links in the first reply
Evening Phase: Check + Reflect
- Collect metrics for today's posts
- Quick reflection using Daily Review Template
- Plan tomorrow: draft content, identify engagement targets
Weekly/Monthly/Quarterly
- Weekly (Sunday evening): Performance review, content audit, A/B test assessment, next week planning. Use Weekly Review Template.
- Monthly: Goal progress evaluation, strategy assessment, competitor analysis, persona check. Use Monthly Review Template.
- Quarterly: Major strategy review, goal reset, persona evolution, skill updates.
Content Strategy
See Content Strategy for the full framework.
Five Content Pillars
| Pillar |
Target % |
Purpose |
| Technical Depth |
40% |
Tips, insights, tutorials — builds authority |
| Industry Pulse |
25% |
Hot takes, predictions, trend analysis — builds thought leadership |
| Builder's Journey |
25% |
Build-in-public, decisions, lessons — builds connection |
| Community Value |
10% |
Questions, polls, resources — builds community |
| Personal Touch |
woven in |
Humor, personality, human moments — builds "活人感" |
Content Pipeline
Ideation → Drafting → Review → Scheduling → Posting → Measurement
Each step has quality checks. See Content Strategy: Content Pipeline for details.
Proven Content Formulas
- Claim + Evidence + CTA: Bold claim, specific proof, discussion prompt
- Story + Lesson + Takeaway: Brief narrative, what happened, actionable insight
- Question + Context + Invitation: Thoughtful question, why you're asking, invite perspectives
- List + Value + CTA: Numbered items with brief explanations, bookmark/follow prompt
- Reaction + Analysis + Prediction: News reference, your unique analysis, what happens next
Content Repurposing
- High-performing thread → 5-7 standalone tweets over the following week
- Popular single tweet → expand into a full thread
- Thread → blog post or newsletter; blog → thread
- Repost top content every 3-4 weeks with fresh phrasing
Thread Strategy
Threads are the highest-leverage growth mechanism on X. See Thread Playbook.
Thread Architecture
Hook (stop the scroll) → Context → Value Delivery (one point per tweet) → Summary → CTA
Key Guidelines
- Optimal length: 5-7 tweets for most founders
- Post at 08:00-10:00 in target audience timezone
- Include visuals in 60-70% of thread tweets
- Prepare day before, post Tuesday-Thursday
- Target: 1-2 threads per week
Multimodal Content
See Multimodal Guide for complete guidance.
Impact
- Native video: ~10x distribution vs text-only
- Images: 2-3x engagement vs text-only
- Visuals increase dwell time (key algorithm signal)
Visual Types
| Type |
Best For |
| Screenshots |
Product demos, code output, real data, dashboards |
| Diagrams |
System architecture, workflows, mental models |
| Code snippets |
Technical tutorials, debugging stories |
| Memes |
Industry humor, personality, cultural commentary |
| Data visualizations |
Research, trends, build-in-public metrics |
| Video (native) |
Product demos, talking head takes, tutorials |
The "活人感" Rule
Every visual should feel like a real person made it. Slightly imperfect screenshots, hand-drawn diagrams, and real workspace photos signal authenticity. Overly polished, stock-photo, or obviously AI-generated visuals signal corporate or fake.
Product Integration ("夹带私货")
See Product Integration for the full framework.
Three Tiers
| Tier |
What |
Frequency |
How |
| Tier 1: Background |
Product exists in your world, not the subject |
Default mode |
Bio, profile, pinned tweet do the work |
| Tier 2: Contextual |
Product mentioned as example within a broader insight |
~10% of posts |
"When we built [X], we found..." |
| Tier 3: Direct |
Product is the subject: launches, milestones, demos |
~10% of posts |
Launch threads, milestone celebrations |
Golden Rule
If you removed the product mention, the tweet should still be valuable. The product is the proof, not the point.
CTA Optimization
- Never put links in the main tweet (30-50% algorithm penalty)
- Soft CTAs work better than hard sells on X
- Match CTA to relationship stage: new followers → "follow for more"; engaged followers → "try it"
Engagement Playbook
See Engagement Playbook for full details.
Engagement Funnel
Stranger → Lurker → Follower → Fan → Advocate → Customer/Partner
Core Circle
Identify 20-30 key accounts. Engage with Tier 1 accounts daily, Tier 2 accounts 3-4x/week, Tier 3 opportunistically. See Watchlist Config.
Reply Quality Framework
| Level |
Type |
Impact |
| S |
Data/Evidence |
Very high |
| A |
Novel Perspective |
High |
| B |
Personal Story |
High |
| C |
Thoughtful Question |
Medium |
| D |
Agreement + Extension |
Medium |
| F |
Empty Agreement ("So true!") |
Zero — never do this |
Additional Channels
- X Spaces: Host bi-weekly audio discussions; invite guests from core circle
- X Communities: Post in 3-5 relevant communities; provide value, not promotion
- DMs: After 3+ public interactions, send genuine (not salesy) direct messages
- X Lists: Private lists for competitors, industry leaders, investors, potential customers
Persona & Voice
See Persona & Voice Guide.
Voice Attributes
Define your position on each spectrum in config/profile.json:
- Technical Depth: Surface ←→ Deep
- Humor: Serious ←→ Playful
- Formality: Casual ←→ Formal
- Vulnerability: Guarded ←→ Open
- Boldness: Cautious ←→ Provocative
Consistency Rules
- Maintain consistent tone across all content (the algorithm learns your pattern)
- Adapt tone to context (technical vs personal vs promotional) while keeping core voice
- Build personality anchors: recurring themes, catchphrases, or running jokes that create recognition
- For bilingual users: English for technical/international content, native language for personal/cultural content
Algorithm Awareness
See Algorithm Guide for complete details.
Key Rules
- First 30 minutes determine reach: Engagement velocity in the first 15-30 min drives 80%+ of total reach
- Reply > Retweet > Bookmark > Like: Algorithm weights replies highest (
1x), likes lowest (0.5x)
- External links are penalized: 30-50% fewer impressions. Links go in first reply.
- Consistency rewards: Sudden posting changes trigger spam detection. Maintain steady cadence.
- Niche specificity: Stay focused on 2-3 topics. Random off-topic posts dilute your algorithm placement.
- Negative signals are devastating: Mute/block/report carry ~-74x weight. Never post hostile content.
- Video gets priority: Native video gets ~10x distribution vs text-only.
Goal Framework
Configure in goals.json. The skill adapts recommendations based on your primary objective and growth stage.
Primary Objectives
| Objective |
Key X Activities |
| Brand building |
Consistent voice, thought leadership content, thread strategy |
| Lead generation |
Product integration, bio link optimization, CTA strategy |
| Fundraising |
Industry analysis, investor engagement, traction posts |
| Hiring |
Engineering challenges, culture posts, team stories |
| Thought leadership |
Deep technical content, contrarian takes, Spaces hosting |
| Community building |
Questions, engagement, Spaces, community participation |
Growth Stages
| Stage |
Followers |
Focus |
| Early |
0-1K |
Finding voice, building core circle, posting consistently |
| Growth |
1K-10K |
Thread strategy, content mix optimization, relationship depth |
| Established |
10K-50K |
Authority content, Spaces hosting, selective engagement |
| Authority |
50K+ |
Maintaining quality, community leadership, platform leverage |
See Growth Benchmarks for realistic targets by stage.
Automated Operations
See Cron Schedule for the full task schedule.
Daily Automated Tasks
| Task |
Timing |
Purpose |
| Morning Scan |
30 min before Window A |
Trending topics, core circle activity, overnight mentions |
| Window A Reminder |
Start of posting window |
Content recommendation based on calendar + scan |
| Midday Collection |
Between windows |
Updated trends, Window A post metrics |
| Window B Reminder |
Start of posting window |
Updated recommendation for evening window |
| Engagement Follow-up |
30 min after Window B |
Identify reply opportunities, quote tweet candidates |
| Mentions Check |
1 hour after Window B |
Categorize and prioritize mentions |
| Evening Review |
End of day |
Metrics collection, daily performance summary |
Validation Workflow
All automated data collection follows this pipeline:
x-timeline → Get tweet list
↓
x-tweet-info → Get detailed metrics per tweet
↓
Cross-validate → ID, author, timestamp consistency
↓
Sanity check → Reasonable data (likes ≤ impressions, no negatives)
↓
Report → Mark anomalies, never guess
Competitor Analysis
See Competitor Framework.
Select 5-8 benchmark accounts across three categories:
- Aspirational (2-3): 10-100x your size, same niche
- Peer (2-3): Similar size and growth stage
- Emerging (1-2): Smaller but growing fast
Analyze monthly: content formulas, engagement patterns, posting times, visual strategy. Extract what works, adapt to your voice.
Tools and Scripts
Data Validation
File: scripts/x_data_validator.py
Validates X data through a 5-layer pipeline: API status, tweet ID presence, cross-validation, metrics completeness, data sanity checks.
Content Planner
File: scripts/content_planner.py
Reads profile, goals, and calendar config to generate daily content recommendations with content mix compliance tracking.
Analytics Reporter
File: scripts/analytics_reporter.py
Generates performance reports using the validation workflow. Produces weekly and monthly analytics with benchmark comparisons.
Smoke Tests (Regression Guard)
Location: tests/ — 63 unit tests covering all three scripts.
Run:
# No dependencies required — uses Python stdlib unittest
python3 -m unittest discover tests/ -v
Run after any script change before shipping.
## Emergency Protocols
### API Failures
1. Retry with exponential backoff (3 attempts max)
2. If still failing: report to user with clear error
3. NEVER proceed with fabricated data
### Content Crisis
1. Pause all automated posts
2. Review recent content for issues
3. Prepare response strategy
4. Notify user immediately
### Data Anomalies
1. Flag immediately in validation report
2. Cross-check with alternative sources
3. Don't include suspicious data in analysis
4. Alert user to investigate
## References
### Methodology & Strategy
- [Operations Methodology](references/methodology.md) — PDCA daily loop, A/B testing, review cadences
- [Content Strategy](references/content-strategy.md) — 5-pillar system, content pipeline, formulas, timing
- [Thread Playbook](references/thread-playbook.md) — Thread architecture, hooks, scheduling, repurposing
- [Multimodal Guide](references/multimodal-guide.md) — Visual types, tools, "活人感" checklist
- [Product Integration](references/product-integration.md) — 3-tier promotion, CTA optimization, launch playbook
### Growth & Engagement
- [Engagement Playbook](references/engagement-playbook.md) — Funnel, core circle, reply quality, DMs, Spaces
- [Persona & Voice Guide](references/persona-voice.md) — Voice development, consistency, language mix
- [Algorithm Guide](references/algorithm-guide.md) — How the X algorithm works, optimization tactics
- [Profile Optimization](references/profile-optimization.md) — Bio, photo, pinned tweet, header
### Analysis & Benchmarks
- [Competitor Framework](references/competitor-framework.md) — Benchmark selection, analysis template
- [Growth Benchmarks](references/growth-benchmarks.md) — Industry data by account size and content type
- [Cron Schedule](references/cron-schedule.md) — Automated task schedule, error handling
### Configuration
- [Profile Config](config/profile.example.json) — Handle, role, product, voice, audience
- [Goals Config](config/goals.example.json) — Objectives, targets, KPIs, content mix
- [Watchlist Config](config/watchlist.example.json) — Core circle, competitors, communities
- [Content Calendar](config/content-calendar.example.json) — Weekly rhythm, posting windows
### Templates
- [Daily Review](templates/daily-review.md)
- [Weekly Review](templates/weekly-review.md)
- [Monthly Review](templates/monthly-review.md)
- [Performance Report](templates/performance-report.md)
## Remember
**Trust is built through consistent reliability.** Every post, every reply, every data point matters. Never compromise on data integrity. Never sacrifice authenticity for engagement.
This skill is a living system. It evolves with every daily review, every weekly analysis, and every quarterly strategy reset. The methodology ensures you're always getting smarter about what works for YOUR specific account, audience, and goals.
1---2name: x-founder-operations3description: Systematic X (Twitter) operations skill for founders, indie developers, and tech professionals. Implements a daily Plan-Do-Check-Act closed loop with content strategy (5-pillar system), multimodal creation, thread growth playbook, engagement and community building, product promotion integration, persona development, competitor analysis, and data-driven continuous improvement. Use when managing an X account, planning content, analyzing tweet performance, engaging with community, running competitive analysis, or optimizing posting strategy.4---5
6
7
8
9### Permission Setup Review
10
11`python scripts/_wildcard_placeholder.py` is an optional setup helper for the `X Founder Operations` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
12
13# X Founder Operations
14
15Systematic X (Twitter) account operations for founders, indie developers, and tech professionals.
16
17## Who This Is For
18
19- **Founders**: Building a brand, generating leads, fundraising, hiring, and establishing thought leadership while running a company
20- **Indie developers**: Growing an audience around products, sharing the build journey, converting followers to users
21- **Tech professionals**: Building a personal brand, establishing domain expertise, expanding professional network
22
23This skill adapts to your specific role, goals, and growth stage through configurable profiles and goals.
24
25## Core Philosophy
26
27### Three Pillars
28
291. **Authenticity First**: Your persona is a focused version of who you really are, not a character you play. People follow people, not brands.
302. **Value Before Promotion**: 80% of content should deliver genuine value. Trust is built slowly and lost quickly.
313. **Data-Driven Evolution**: Every post generates data. Every data point informs the next decision. Strategy evolves through empirical results, not gut feeling.
32
33### Data Integrity (Non-Negotiable)
34
35- **NEVER fabricate tweet content, metrics, or URLs**
36- **NEVER guess or hallucinate to fill data gaps**
37- **ALWAYS validate data through the validation workflow**
38- **ALWAYS mark missing data as `null`, never assume values**
39
40When API calls fail: STOP, report the failure honestly, and never proceed with fabricated data. See [Data Validation Script](scripts/x_data_validator.py) for the full validation workflow.
41
42## Quick Start
43
44### 1. Set Up Your Profile
45
46Copy and customize the config templates:
47
48```
49config/profile.example.json → config/profile.json
50config/goals.example.json → config/goals.json
51config/watchlist.example.json → config/watchlist.json
52config/content-calendar.example.json → config/content-calendar.json
53```
54
55Fill in your handle, role, product info, voice attributes, and target audience. See [Profile Optimization](references/profile-optimization.md) for guidance on optimizing your X profile.
56
57### 2. Define Your Goals
58
59In `config/goals.json`, set:
60- Primary objective (brand building, lead gen, fundraising, hiring, thought leadership)
61- Growth stage (early, growth, established, authority)
62- Monthly and quarterly targets
63- Content mix ratios
64
65See [Growth Benchmarks](references/growth-benchmarks.md) for realistic targets by growth stage.
66
67### 3. Build Your Watchlist
68
69In `config/watchlist.json`, identify:
70- 5-10 core circle accounts for daily engagement
71- 3-5 competitor accounts to monitor
72- Industry and media accounts to track
73- Relevant X Communities to join
74
75### 4. Start the Daily Loop
76
77Follow the [Operations Methodology](references/methodology.md) PDCA loop:
78
79```
80Morning: Scan → Plan → Warm Up (30-45 min)
81Daytime: Create → Post → Engage (throughout the day)
82Evening: Check metrics → Reflect → Plan tomorrow (15-20 min)
83```
84
85## Daily Operations Loop
86
87The core operating system. See [Methodology](references/methodology.md) for full details.
88
89### Morning Phase: Plan + Warm Up
90
911. **Scan**: Check overnight mentions, core circle activity, trending topics
922. **Plan**: Select today's content from calendar, prepare tweet drafts
933. **Warm up**: Spend 15-20 min replying to 10-15 accounts from your core circle (this primes the algorithm before your own posts)
94
95### Execution Phase: Create + Post + Engage
96
974. **Post** 2-3 tweets at optimal windows (see [Cron Schedule](references/cron-schedule.md)), spaced 2-3 hours apart
985. **Stay active** 30-60 min after each post — reply to every comment in the first hour
996. **Engage** with core circle and community 2-3 times throughout the day
1007. No external links in main tweet body — always put links in the first reply
101
102### Evening Phase: Check + Reflect
103
1048. **Collect metrics** for today's posts
1059. **Quick reflection** using [Daily Review Template](templates/daily-review.md)
10610. **Plan tomorrow**: draft content, identify engagement targets
107
108### Weekly/Monthly/Quarterly
109
110- **Weekly** (Sunday evening): Performance review, content audit, A/B test assessment, next week planning. Use [Weekly Review Template](templates/weekly-review.md).
111- **Monthly**: Goal progress evaluation, strategy assessment, competitor analysis, persona check. Use [Monthly Review Template](templates/monthly-review.md).
112- **Quarterly**: Major strategy review, goal reset, persona evolution, skill updates.
113
114## Content Strategy
115
116See [Content Strategy](references/content-strategy.md) for the full framework.
117
118### Five Content Pillars
119
120| Pillar | Target % | Purpose |
121|--------|----------|---------|
122| Technical Depth | 40% | Tips, insights, tutorials — builds authority |
123| Industry Pulse | 25% | Hot takes, predictions, trend analysis — builds thought leadership |
124| Builder's Journey | 25% | Build-in-public, decisions, lessons — builds connection |
125| Community Value | 10% | Questions, polls, resources — builds community |
126| Personal Touch | woven in | Humor, personality, human moments — builds "活人感" |
127
128### Content Pipeline
129
130```
131Ideation → Drafting → Review → Scheduling → Posting → Measurement
132```
133
134Each step has quality checks. See [Content Strategy: Content Pipeline](references/content-strategy.md) for details.
135
136### Proven Content Formulas
137
138- **Claim + Evidence + CTA**: Bold claim, specific proof, discussion prompt
139- **Story + Lesson + Takeaway**: Brief narrative, what happened, actionable insight
140- **Question + Context + Invitation**: Thoughtful question, why you're asking, invite perspectives
141- **List + Value + CTA**: Numbered items with brief explanations, bookmark/follow prompt
142- **Reaction + Analysis + Prediction**: News reference, your unique analysis, what happens next
143
144### Content Repurposing
145
146- High-performing thread → 5-7 standalone tweets over the following week
147- Popular single tweet → expand into a full thread
148- Thread → blog post or newsletter; blog → thread
149- Repost top content every 3-4 weeks with fresh phrasing
150
151## Thread Strategy
152
153Threads are the highest-leverage growth mechanism on X. See [Thread Playbook](references/thread-playbook.md).
154
155### Thread Architecture
156
157```
158Hook (stop the scroll) → Context → Value Delivery (one point per tweet) → Summary → CTA
159```
160
161### Key Guidelines
162
163- Optimal length: 5-7 tweets for most founders
164- Post at 08:00-10:00 in target audience timezone
165- Include visuals in 60-70% of thread tweets
166- Prepare day before, post Tuesday-Thursday
167- Target: 1-2 threads per week
168
169## Multimodal Content
170
171See [Multimodal Guide](references/multimodal-guide.md) for complete guidance.
172
173### Impact
174
175- Native video: ~10x distribution vs text-only
176- Images: 2-3x engagement vs text-only
177- Visuals increase dwell time (key algorithm signal)
178
179### Visual Types
180
181| Type | Best For |
182|------|----------|
183| Screenshots | Product demos, code output, real data, dashboards |
184| Diagrams | System architecture, workflows, mental models |
185| Code snippets | Technical tutorials, debugging stories |
186| Memes | Industry humor, personality, cultural commentary |
187| Data visualizations | Research, trends, build-in-public metrics |
188| Video (native) | Product demos, talking head takes, tutorials |
189
190### The "活人感" Rule
191
192Every visual should feel like a real person made it. Slightly imperfect screenshots, hand-drawn diagrams, and real workspace photos signal authenticity. Overly polished, stock-photo, or obviously AI-generated visuals signal corporate or fake.
193
194## Product Integration ("夹带私货")
195
196See [Product Integration](references/product-integration.md) for the full framework.
197
198### Three Tiers
199
200| Tier | What | Frequency | How |
201|------|------|-----------|-----|
202| Tier 1: Background | Product exists in your world, not the subject | Default mode | Bio, profile, pinned tweet do the work |
203| Tier 2: Contextual | Product mentioned as example within a broader insight | ~10% of posts | "When we built [X], we found..." |
204| Tier 3: Direct | Product is the subject: launches, milestones, demos | ~10% of posts | Launch threads, milestone celebrations |
205
206### Golden Rule
207
208If you removed the product mention, the tweet should still be valuable. The product is the proof, not the point.
209
210### CTA Optimization
211
212- Never put links in the main tweet (30-50% algorithm penalty)
213- Soft CTAs work better than hard sells on X
214- Match CTA to relationship stage: new followers → "follow for more"; engaged followers → "try it"
215
216## Engagement Playbook
217
218See [Engagement Playbook](references/engagement-playbook.md) for full details.
219
220### Engagement Funnel
221
222```
223Stranger → Lurker → Follower → Fan → Advocate → Customer/Partner
224```
225
226### Core Circle
227
228Identify 20-30 key accounts. Engage with Tier 1 accounts daily, Tier 2 accounts 3-4x/week, Tier 3 opportunistically. See [Watchlist Config](config/watchlist.example.json).
229
230### Reply Quality Framework
231
232| Level | Type | Impact |
233|-------|------|--------|
234| S | Data/Evidence | Very high |
235| A | Novel Perspective | High |
236| B | Personal Story | High |
237| C | Thoughtful Question | Medium |
238| D | Agreement + Extension | Medium |
239| F | Empty Agreement ("So true!") | Zero — never do this |
240
241### Additional Channels
242
243- **X Spaces**: Host bi-weekly audio discussions; invite guests from core circle
244- **X Communities**: Post in 3-5 relevant communities; provide value, not promotion
245- **DMs**: After 3+ public interactions, send genuine (not salesy) direct messages
246- **X Lists**: Private lists for competitors, industry leaders, investors, potential customers
247
248## Persona & Voice
249
250See [Persona & Voice Guide](references/persona-voice.md).
251
252### Voice Attributes
253
254Define your position on each spectrum in `config/profile.json`:
255
256- Technical Depth: Surface ←→ Deep
257- Humor: Serious ←→ Playful
258- Formality: Casual ←→ Formal
259- Vulnerability: Guarded ←→ Open
260- Boldness: Cautious ←→ Provocative
261
262### Consistency Rules
263
264- Maintain consistent tone across all content (the algorithm learns your pattern)
265- Adapt tone to context (technical vs personal vs promotional) while keeping core voice
266- Build personality anchors: recurring themes, catchphrases, or running jokes that create recognition
267- For bilingual users: English for technical/international content, native language for personal/cultural content
268
269## Algorithm Awareness
270
271See [Algorithm Guide](references/algorithm-guide.md) for complete details.
272
273### Key Rules
274
2751. **First 30 minutes determine reach**: Engagement velocity in the first 15-30 min drives 80%+ of total reach
2762. **Reply > Retweet > Bookmark > Like**: Algorithm weights replies highest (~1x), likes lowest (~0.5x)
2773. **External links are penalized**: 30-50% fewer impressions. Links go in first reply.
2784. **Consistency rewards**: Sudden posting changes trigger spam detection. Maintain steady cadence.
2795. **Niche specificity**: Stay focused on 2-3 topics. Random off-topic posts dilute your algorithm placement.
2806. **Negative signals are devastating**: Mute/block/report carry ~-74x weight. Never post hostile content.
2817. **Video gets priority**: Native video gets ~10x distribution vs text-only.
282
283## Goal Framework
284
285Configure in [goals.json](config/goals.example.json). The skill adapts recommendations based on your primary objective and growth stage.
286
287### Primary Objectives
288
289| Objective | Key X Activities |
290|-----------|-----------------|
291| Brand building | Consistent voice, thought leadership content, thread strategy |
292| Lead generation | Product integration, bio link optimization, CTA strategy |
293| Fundraising | Industry analysis, investor engagement, traction posts |
294| Hiring | Engineering challenges, culture posts, team stories |
295| Thought leadership | Deep technical content, contrarian takes, Spaces hosting |
296| Community building | Questions, engagement, Spaces, community participation |
297
298### Growth Stages
299
300| Stage | Followers | Focus |
301|-------|-----------|-------|
302| Early | 0-1K | Finding voice, building core circle, posting consistently |
303| Growth | 1K-10K | Thread strategy, content mix optimization, relationship depth |
304| Established | 10K-50K | Authority content, Spaces hosting, selective engagement |
305| Authority | 50K+ | Maintaining quality, community leadership, platform leverage |
306
307See [Growth Benchmarks](references/growth-benchmarks.md) for realistic targets by stage.
308
309## Automated Operations
310
311See [Cron Schedule](references/cron-schedule.md) for the full task schedule.
312
313### Daily Automated Tasks
314
315| Task | Timing | Purpose |
316|------|--------|---------|
317| Morning Scan | 30 min before Window A | Trending topics, core circle activity, overnight mentions |
318| Window A Reminder | Start of posting window | Content recommendation based on calendar + scan |
319| Midday Collection | Between windows | Updated trends, Window A post metrics |
320| Window B Reminder | Start of posting window | Updated recommendation for evening window |
321| Engagement Follow-up | 30 min after Window B | Identify reply opportunities, quote tweet candidates |
322| Mentions Check | 1 hour after Window B | Categorize and prioritize mentions |
323| Evening Review | End of day | Metrics collection, daily performance summary |
324
325### Validation Workflow
326
327All automated data collection follows this pipeline:
328
329```
330x-timeline → Get tweet list
331 ↓
332x-tweet-info → Get detailed metrics per tweet
333 ↓
334Cross-validate → ID, author, timestamp consistency
335 ↓
336Sanity check → Reasonable data (likes ≤ impressions, no negatives)
337 ↓
338Report → Mark anomalies, never guess
339```
340
341## Competitor Analysis
342
343See [Competitor Framework](references/competitor-framework.md).
344
345Select 5-8 benchmark accounts across three categories:
346- **Aspirational** (2-3): 10-100x your size, same niche
347- **Peer** (2-3): Similar size and growth stage
348- **Emerging** (1-2): Smaller but growing fast
349
350Analyze monthly: content formulas, engagement patterns, posting times, visual strategy. Extract what works, adapt to your voice.
351
352## Tools and Scripts
353
354### Data Validation
355**File**: `scripts/x_data_validator.py`
356Validates X data through a 5-layer pipeline: API status, tweet ID presence, cross-validation, metrics completeness, data sanity checks.
357
358### Content Planner
359**File**: `scripts/content_planner.py`
360Reads profile, goals, and calendar config to generate daily content recommendations with content mix compliance tracking.
361
362### Analytics Reporter
363**File**: `scripts/analytics_reporter.py`
364Generates performance reports using the validation workflow. Produces weekly and monthly analytics with benchmark comparisons.
365
366### Smoke Tests (Regression Guard)
367
368**Location**: `tests/` — 63 unit tests covering all three scripts.
369
370Run:
371```bash
372# No dependencies required — uses Python stdlib unittest
373python3 -m unittest discover tests/ -v
374
375Run after any script change before shipping.
376
377## Emergency Protocols
378
379### API Failures
3801. Retry with exponential backoff (3 attempts max)
3812. If still failing: report to user with clear error
3823. NEVER proceed with fabricated data
383
384### Content Crisis
3851. Pause all automated posts
3862. Review recent content for issues
3873. Prepare response strategy
3884. Notify user immediately
389
390### Data Anomalies
3911. Flag immediately in validation report
3922. Cross-check with alternative sources
3933. Don't include suspicious data in analysis
3944. Alert user to investigate
395
396## References
397
398### Methodology & Strategy
399- [Operations Methodology](references/methodology.md) — PDCA daily loop, A/B testing, review cadences
400- [Content Strategy](references/content-strategy.md) — 5-pillar system, content pipeline, formulas, timing
401- [Thread Playbook](references/thread-playbook.md) — Thread architecture, hooks, scheduling, repurposing
402- [Multimodal Guide](references/multimodal-guide.md) — Visual types, tools, "活人感" checklist
403- [Product Integration](references/product-integration.md) — 3-tier promotion, CTA optimization, launch playbook
404
405### Growth & Engagement
406- [Engagement Playbook](references/engagement-playbook.md) — Funnel, core circle, reply quality, DMs, Spaces
407- [Persona & Voice Guide](references/persona-voice.md) — Voice development, consistency, language mix
408- [Algorithm Guide](references/algorithm-guide.md) — How the X algorithm works, optimization tactics
409- [Profile Optimization](references/profile-optimization.md) — Bio, photo, pinned tweet, header
410
411### Analysis & Benchmarks
412- [Competitor Framework](references/competitor-framework.md) — Benchmark selection, analysis template
413- [Growth Benchmarks](references/growth-benchmarks.md) — Industry data by account size and content type
414- [Cron Schedule](references/cron-schedule.md) — Automated task schedule, error handling
415
416### Configuration
417- [Profile Config](config/profile.example.json) — Handle, role, product, voice, audience
418- [Goals Config](config/goals.example.json) — Objectives, targets, KPIs, content mix
419- [Watchlist Config](config/watchlist.example.json) — Core circle, competitors, communities
420- [Content Calendar](config/content-calendar.example.json) — Weekly rhythm, posting windows
421
422### Templates
423- [Daily Review](templates/daily-review.md)
424- [Weekly Review](templates/weekly-review.md)
425- [Monthly Review](templates/monthly-review.md)
426- [Performance Report](templates/performance-report.md)
427
428## Remember
429
430**Trust is built through consistent reliability.** Every post, every reply, every data point matters. Never compromise on data integrity. Never sacrifice authenticity for engagement.
431
432This skill is a living system. It evolves with every daily review, every weekly analysis, and every quarterly strategy reset. The methodology ensures you're always getting smarter about what works for YOUR specific account, audience, and goals.