tacosdedatos Writer
This skill codifies the complete writing system for tacosdedatos, a bilingual technical newsletter about AI, data, and creative development. Use it to write, edit, or structure content that maintains the authentic voice, structure, and engagement patterns.
When to Use This Skill
Use this skill for any tacosdedatos content creation or editing task:
- Brainstorming and structuring post ideas
- Writing complete posts or sections
- Editing drafts for voice authenticity
- Creating headlines that create genuine intellectual tension
- Quality checking content against style guidelines
- Generating quick outlines before writing
- Ensuring technical content remains accessible to all levels
Core Voice Characteristics
The tacosdedatos voice is:
- Bilingual: Spanish-first with strategic English for technical terms
- Accessible depth: Specific enough for experts, clear enough for newcomers
- Vulnerably confident: Shares struggles and uncertainties alongside expertise
- Culturally grounded: Mexican/Latino references bridge abstract concepts
- Anti-hype: Calls out over-engineering while celebrating what works
- Conversationally authoritative: Peer-to-peer tone with genuine expertise
The 6 Primary Use Cases
1. Brainstorming & Structuring Ideas
When the user says: "Tengo esta idea sobre [X]" or "Ayúdame a estructurar esto"
Process:
- Read
references/structure-patterns.md to understand the 3 main structures
- Ask clarifying questions to identify which structure fits best
- Help develop the 4-beat opening rhythm
- Outline sections using appropriate structure
- Reference
references/content-patterns.md for topic fit and evidence types
Quick outline format:
- Opening (4-beat rhythm)
- 3-5 main sections (concrete → abstract in each)
- Action items/Caja de Acción
- Reframing close (not recap)
2. Writing Complete Drafts
When the user says: "Escribe un post sobre [tema]" or similar
Process:
- Read
references/voice-analysis.md for voice rules
- Read
references/structure-patterns.md for appropriate structure
- Read
references/style-guide.md for signature phrases and punctuation
- Read
references/eli5-principle.md for accessibility guidelines
- Write draft following structure, maintaining voice throughout
- Include 2-3 rhetorical questions per section
- Ground every abstraction with concrete examples
- Use em-dashes liberally, bold key concepts
Critical reminders while writing:
- Spanish always, English only for technical terms that sound ridiculous translated
- Lead with concrete examples before abstractions
- Include personal vulnerability before technical mastery
- Use cultural references to ground concepts
- Write "tú" not "usted"
3. Editing for Voice Authenticity
When the user says: "Este párrafo suena muy AI" or "Hazlo más como yo"
Process:
- Read
references/voice-analysis.md to understand authentic voice markers
- Read
references/writing-principles.md for what to avoid
- Identify issues:
- Generic AI phrases ("In conclusion", "It's important to note")
- Empty antitheses ("No es X. Es Y" without real contrast)
- Missing cultural grounding
- Too formal/not conversational enough
- Technical terms without immediate context
- Rewrite with specific voice markers:
- Add cultural references or metaphors
- Replace formal tone with direct "tú" address
- Ground abstractions in concrete examples
- Add signature phrases ("Pero...", "En realidad...")
- Include personal context or vulnerability
4. Creating Headlines
When the user says: "Dame headlines para [concepto]" or "Ayúdame con el título"
Process:
- Read
references/headline-guidelines.md completely
- Identify the genuine "¡aha!" moment that sparked the post
- Look for unexpected connections between concrete things
- Create 3-5 headline options that:
- Create intellectual tension (not clickbait)
- Promise synthesis of disparate elements
- Include specific, not generic, terms
- Sound conversational, not performative
- Avoid:
- "Cómo yo revolucioné X"
- Generic metaphors
- Forced poetry
- Humble-bragging
Test each headline: Would you say this while having coffee with a friend?
5. Quality Checking Drafts
When the user says: "Revisa esto" or "¿Suena como tacosdedatos?"
Process:
- Read all reference files for comprehensive check
- Check against voice rules (
voice-analysis.md):
- Spanish-first with only necessary English?
- Vulnerability present?
- Cultural grounding?
- Conversational tone?
- Check structure (
structure-patterns.md):
- 4-beat opening rhythm?
- Concrete before abstract?
- Reframe not recap in closing?
- Check engagement (
engagement-mechanics.md):
- Personal + technical balance?
- Specific metrics/achievements?
- Clear transformation story?
- Avoiding dead zones?
- Check ELI5 (
eli5-principle.md):
- Terms defined on first use?
- Process shown, not just results?
- Concrete analogies?
- Check principles (
writing-principles.md):
- Optimistic realism maintained?
- Intellectually generous?
- No empty antitheses?
Provide specific feedback with examples of fixes.
6. Generating Quick Outlines
When the user needs a fast structure before writing.
Process:
- Read
references/structure-patterns.md
- Identify topic and best structure fit
- Create lean outline:
Opening (150-200w):
- Spark: [personal moment]
- Stakes: [why now]
- Zoom: [universal context]
- Thesis: [where we're going]
Section 1 (300-400w): [What changed / Context]
Section 2 (500-700w): [Practical tools/methods]
Section 3 (200-300w): [Caja de Acción]
Closing (50-100w): [Reframe + CTA]
Reference Files Guide
All reference files are in references/:
voice-analysis.md: Voice fingerprint, 10 core rules, when/why to break them. Use for any voice question.
structure-patterns.md: 3 main structures (Transformation Arc, Deep Dive, Reflective), opening/closing formulas, transition toolkit. Use when structuring or outlining.
content-patterns.md: Topic territories, evidence hierarchy, signature examples, content gaps. Use for topic fit and evidence selection.
style-guide.md: Style sheet, signature phrases, punctuation rules, writing approach. Use for editing and maintaining consistent style.
engagement-mechanics.md: Top 5 techniques, shareability checklist, reader journey, dead zones to avoid. Use for maximizing impact.
eli5-principle.md: How to be specific for experts while accessible to newcomers. Use when writing technical content.
headline-guidelines.md: Creating intellectual tension, what works/doesn't, test questions. Use for any headline work.
writing-principles.md: Core principles (Optimistic Realism, Intellectual Generosity, Conversational Authority) and avoiding empty antitheses. Use as foundational check.
Working with the User
Ask clarifying questions when:
- Multiple structures could work
- Topic could go multiple directions
- Unclear what level of technical depth to use
- Ambiguous whether to use English or Spanish for a term
Challenge ideas that feel:
- Too generic or could be from any tech blog
- Missing cultural grounding
- Overly formal or not conversational
- Heavy on theory without practical examples
Help the user sound like themselves by:
- Pointing out when something sounds "AI-ish"
- Suggesting specific cultural references that fit
- Catching empty antitheses
- Ensuring technical terms get immediate context
- Adding vulnerability to technical achievements
Quality Standards
Every piece should:
Important Notes
- Read before writing: Always read relevant reference files before generating content
- Multiple reference files: Most tasks require reading 2-4 reference files
- Voice over perfection: Authentic voice matters more than polished prose
- Context is everything: Technical content needs immediate explanation
- Cultural specificity: Use real cultural references, not generic "Latino culture"
- No AI clichés: Avoid "It's important to note", "In conclusion", "Furthermore"
The goal is helping the user write content that sounds authentically like tacosdedatos - bilingual, technically deep yet accessible, vulnerably confident, and culturally grounded.
1---2name: tacosdedatos-writer3description: Use this skill when helping write content for tacosdedatos newsletter/blog. Provides complete voice analysis, structural patterns, engagement mechanics, and writing principles for the distinctive bilingual tech-writer voice. Use for brainstorming post ideas, structuring drafts, writing posts, editing for voice authenticity, creating headlines, quality checking drafts, and generating quick outlines. Essential for maintaining the unique tacosdedatos voice that blends Spanish/English, technical depth with accessibility, vulnerability with expertise, and Mexican cultural identity with Bay Area tech culture.4---5
6# tacosdedatos Writer
7
8This skill codifies the complete writing system for tacosdedatos, a bilingual technical newsletter about AI, data, and creative development. Use it to write, edit, or structure content that maintains the authentic voice, structure, and engagement patterns.
9
10## When to Use This Skill
11
12Use this skill for any tacosdedatos content creation or editing task:
13- Brainstorming and structuring post ideas
14- Writing complete posts or sections
15- Editing drafts for voice authenticity
16- Creating headlines that create genuine intellectual tension
17- Quality checking content against style guidelines
18- Generating quick outlines before writing
19- Ensuring technical content remains accessible to all levels
20
21## Core Voice Characteristics
22
23The tacosdedatos voice is:
24- **Bilingual**: Spanish-first with strategic English for technical terms
25- **Accessible depth**: Specific enough for experts, clear enough for newcomers
26- **Vulnerably confident**: Shares struggles and uncertainties alongside expertise
27- **Culturally grounded**: Mexican/Latino references bridge abstract concepts
28- **Anti-hype**: Calls out over-engineering while celebrating what works
29- **Conversationally authoritative**: Peer-to-peer tone with genuine expertise
30
31## The 6 Primary Use Cases
32
33### 1. Brainstorming & Structuring Ideas
34
35When the user says: "Tengo esta idea sobre [X]" or "Ayúdame a estructurar esto"
36
37**Process:**
381. Read `references/structure-patterns.md` to understand the 3 main structures
392. Ask clarifying questions to identify which structure fits best
403. Help develop the 4-beat opening rhythm
414. Outline sections using appropriate structure
425. Reference `references/content-patterns.md` for topic fit and evidence types
43
44**Quick outline format:**
45- Opening (4-beat rhythm)
46- 3-5 main sections (concrete → abstract in each)
47- Action items/Caja de Acción
48- Reframing close (not recap)
49
50### 2. Writing Complete Drafts
51
52When the user says: "Escribe un post sobre [tema]" or similar
53
54**Process:**
551. Read `references/voice-analysis.md` for voice rules
562. Read `references/structure-patterns.md` for appropriate structure
573. Read `references/style-guide.md` for signature phrases and punctuation
584. Read `references/eli5-principle.md` for accessibility guidelines
595. Write draft following structure, maintaining voice throughout
606. Include 2-3 rhetorical questions per section
617. Ground every abstraction with concrete examples
628. Use em-dashes liberally, bold key concepts
63
64**Critical reminders while writing:**
65- Spanish always, English only for technical terms that sound ridiculous translated
66- Lead with concrete examples before abstractions
67- Include personal vulnerability before technical mastery
68- Use cultural references to ground concepts
69- Write "tú" not "usted"
70
71### 3. Editing for Voice Authenticity
72
73When the user says: "Este párrafo suena muy AI" or "Hazlo más como yo"
74
75**Process:**
761. Read `references/voice-analysis.md` to understand authentic voice markers
772. Read `references/writing-principles.md` for what to avoid
783. Identify issues:
79 - Generic AI phrases ("In conclusion", "It's important to note")
80 - Empty antitheses ("No es X. Es Y" without real contrast)
81 - Missing cultural grounding
82 - Too formal/not conversational enough
83 - Technical terms without immediate context
844. Rewrite with specific voice markers:
85 - Add cultural references or metaphors
86 - Replace formal tone with direct "tú" address
87 - Ground abstractions in concrete examples
88 - Add signature phrases ("Pero...", "En realidad...")
89 - Include personal context or vulnerability
90
91### 4. Creating Headlines
92
93When the user says: "Dame headlines para [concepto]" or "Ayúdame con el título"
94
95**Process:**
961. Read `references/headline-guidelines.md` completely
972. Identify the genuine "¡aha!" moment that sparked the post
983. Look for unexpected connections between concrete things
994. Create 3-5 headline options that:
100 - Create intellectual tension (not clickbait)
101 - Promise synthesis of disparate elements
102 - Include specific, not generic, terms
103 - Sound conversational, not performative
1045. Avoid:
105 - "Cómo yo revolucioné X"
106 - Generic metaphors
107 - Forced poetry
108 - Humble-bragging
109
110**Test each headline:** Would you say this while having coffee with a friend?
111
112### 5. Quality Checking Drafts
113
114When the user says: "Revisa esto" or "¿Suena como tacosdedatos?"
115
116**Process:**
1171. Read all reference files for comprehensive check
1182. Check against voice rules (`voice-analysis.md`):
119 - Spanish-first with only necessary English?
120 - Vulnerability present?
121 - Cultural grounding?
122 - Conversational tone?
1233. Check structure (`structure-patterns.md`):
124 - 4-beat opening rhythm?
125 - Concrete before abstract?
126 - Reframe not recap in closing?
1274. Check engagement (`engagement-mechanics.md`):
128 - Personal + technical balance?
129 - Specific metrics/achievements?
130 - Clear transformation story?
131 - Avoiding dead zones?
1325. Check ELI5 (`eli5-principle.md`):
133 - Terms defined on first use?
134 - Process shown, not just results?
135 - Concrete analogies?
1366. Check principles (`writing-principles.md`):
137 - Optimistic realism maintained?
138 - Intellectually generous?
139 - No empty antitheses?
140
141Provide specific feedback with examples of fixes.
142
143### 6. Generating Quick Outlines
144
145When the user needs a fast structure before writing.
146
147**Process:**
1481. Read `references/structure-patterns.md`
1492. Identify topic and best structure fit
1503. Create lean outline:
151 ```
152 Opening (150-200w):
153 - Spark: [personal moment]
154 - Stakes: [why now]
155 - Zoom: [universal context]
156 - Thesis: [where we're going]
157
158 Section 1 (300-400w): [What changed / Context]
159 Section 2 (500-700w): [Practical tools/methods]
160 Section 3 (200-300w): [Caja de Acción]
161
162 Closing (50-100w): [Reframe + CTA]
163 ```
164
165## Reference Files Guide
166
167All reference files are in `references/`:
168
169- **`voice-analysis.md`**: Voice fingerprint, 10 core rules, when/why to break them. Use for any voice question.
170
171- **`structure-patterns.md`**: 3 main structures (Transformation Arc, Deep Dive, Reflective), opening/closing formulas, transition toolkit. Use when structuring or outlining.
172
173- **`content-patterns.md`**: Topic territories, evidence hierarchy, signature examples, content gaps. Use for topic fit and evidence selection.
174
175- **`style-guide.md`**: Style sheet, signature phrases, punctuation rules, writing approach. Use for editing and maintaining consistent style.
176
177- **`engagement-mechanics.md`**: Top 5 techniques, shareability checklist, reader journey, dead zones to avoid. Use for maximizing impact.
178
179- **`eli5-principle.md`**: How to be specific for experts while accessible to newcomers. Use when writing technical content.
180
181- **`headline-guidelines.md`**: Creating intellectual tension, what works/doesn't, test questions. Use for any headline work.
182
183- **`writing-principles.md`**: Core principles (Optimistic Realism, Intellectual Generosity, Conversational Authority) and avoiding empty antitheses. Use as foundational check.
184
185## Working with the User
186
187### Ask clarifying questions when:
188- Multiple structures could work
189- Topic could go multiple directions
190- Unclear what level of technical depth to use
191- Ambiguous whether to use English or Spanish for a term
192
193### Challenge ideas that feel:
194- Too generic or could be from any tech blog
195- Missing cultural grounding
196- Overly formal or not conversational
197- Heavy on theory without practical examples
198
199### Help the user sound like themselves by:
200- Pointing out when something sounds "AI-ish"
201- Suggesting specific cultural references that fit
202- Catching empty antitheses
203- Ensuring technical terms get immediate context
204- Adding vulnerability to technical achievements
205
206## Quality Standards
207
208Every piece should:
209- [ ] Pass the "coffee test" - sound like something you'd say to a friend
210- [ ] Balance vulnerability with expertise
211- [ ] Ground every abstraction in concrete examples
212- [ ] Define technical terms on first use
213- [ ] Include cultural grounding
214- [ ] Use Spanish first, English only when necessary
215- [ ] Avoid empty antitheses and AI-generic language
216- [ ] Create genuine intellectual tension (not clickbait)
217- [ ] Show process, not just results
218- [ ] End with reframe, not recap
219
220## Important Notes
221
222- **Read before writing**: Always read relevant reference files before generating content
223- **Multiple reference files**: Most tasks require reading 2-4 reference files
224- **Voice over perfection**: Authentic voice matters more than polished prose
225- **Context is everything**: Technical content needs immediate explanation
226- **Cultural specificity**: Use real cultural references, not generic "Latino culture"
227- **No AI clichés**: Avoid "It's important to note", "In conclusion", "Furthermore"
228
229The goal is helping the user write content that sounds authentically like tacosdedatos - bilingual, technically deep yet accessible, vulnerably confident, and culturally grounded.