@muskanmeet/invoicing-design-system 0.1.0

package/.local/secondary_skills/podcast-marketing/content-templates.md

@@ -0,0 +1,325 @@
+# Content Templates
+
+Detailed templates and examples for each marketing content type generated from podcast episodes.
+
+## Critical Rules
+
+1. **Generate each content piece in a SEPARATE LLM call.** Never batch multiple outputs with separators (e.g., "---SEPARATOR---"). This causes content bleeding between files and quality degradation.
+2. **Anti-repetition: Each platform must lead with a different atom.** Before generating content, assign atoms to platforms (see SKILL.md Step 2). Pass only the assigned atom(s) to each generation call.
+
+3. **Validate constraints before saving.** Count characters (Twitter), words (blog), and check that no quote appears in more than 2 outputs.
+
+## Twitter/X Thread Template
+
+Structure a 5-8 tweet thread. Each tweet should stand alone while building a narrative arc.
+
+**Tweet 1 — The Hook:**
+
+Lead with the most surprising, contrarian, or counter-intuitive point. Frame as a revelation or challenge to conventional wisdom.
+
+```text
+
+Most people think [common belief].
+
+But @GuestName just explained why that's completely wrong.
+
+A thread on [topic] 🧵
+
+```
+
+**Tweets 2-6 — Key Insights:**
+
+One insight per tweet. Use the guest's own phrasing when it's punchy. Add brief context when needed.
+
+```text
+
+1/ "[Direct quote from guest]"
+
+This matters because [one-sentence context].
+
+```
+
+**Final Tweet — CTA:**
+
+```text
+
+Full conversation with @GuestName on [Podcast Name]:
+
+[Episode link]
+
+If this resonated, RT tweet 1 so others find it.
+
+```
+
+**Rules:**
+
+- **HARD LIMIT: Under 280 characters per tweet (including URLs and spaces).** Validate by counting `len(tweet_text)` for each tweet. If over 280, rewrite or split into two tweets.
+- No hashtags except in the final tweet (1-2 max)
+
+- Use line breaks for readability
+- Numbers and lists perform well — use "3 things I learned" framing when appropriate
+
+- If a direct quote exceeds ~200 chars, paraphrase it shorter or split the quote across tweet + reply
+
+**Validation script:**
+
+```python
+
+def validate_thread(tweets: list[str]) -> list[str]:
+
+errors = []
+
+for i, tweet in enumerate(tweets, 1):
+
+if len(tweet) > 280:
+
+errors.append(f"Tweet {i} is {len(tweet)} chars (max 280): {tweet[:50]}...")
+
+return errors
+
+```
+
+## LinkedIn Post Template
+
+Single long-form post. Professional but not corporate — LinkedIn rewards personal perspective and storytelling.
+
+```text
+
+[Bold opening statement or question that challenges assumptions]
+
+I just had a conversation with [Guest Name] about [topic], and one thing completely shifted my thinking:
+
+[Key insight \#1 — 2-3 sentences expanding on it]
+
+[Key insight \#2 — 2-3 sentences]
+
+[Key insight \#3 — brief]
+
+The biggest takeaway? [One-sentence summary of the most actionable point].
+
+What's your experience with [topic]? I'd love to hear how others are thinking about this.
+
+🎙️ Full episode: [link]
+
+```
+
+**Rules:**
+
+- 1,200-1,500 characters total
+- First line is crucial — it appears above the "see more" fold
+
+- Use line breaks between paragraphs (LinkedIn penalizes walls of text)
+- End with an open question to drive comments
+
+- Avoid corporate jargon — write like a real person
+
+## Instagram Caption Template
+
+Casual, scroll-stopping, designed for the feed or carousel format.
+
+```text
+
+[Attention-grabbing first line — question, bold claim, or "did you know"]
+
+[2-3 sentences about the key insight, written conversationally]
+
+[Pull quote from the guest if applicable]
+
+🎧 New episode out now — link in bio
+
+#Podcast \#[TopicHashtag] \#[NicheHashtag] \#[GuestNameHashtag] \#[BrandHashtag]
+
+```
+
+**Rules:**
+
+- 300-500 characters for the main copy (before hashtags)
+- Front-load the hook — first line shows in feed preview
+
+- 3-5 hashtags max (mix of broad and niche)
+- Mention the guest's handle if they have one
+
+## Blog Post Template
+
+800-1,200 words. Optimized for SEO and readability.
+
+```markdown
+
+# [Compelling Title — Not Just the Episode Title]
+
+[Opening paragraph: Lead with the most compelling insight. Do NOT start with
+
+"In this episode of..." or "I recently spoke with...". Start with the idea.]
+
+## [Subheading for Key Topic 1]
+
+[2-3 paragraphs expanding on the first major takeaway. Include context,
+
+examples from the conversation, and why this matters to the reader.]
+
+> "[Pull quote from the transcript]" — [Speaker Name]
+
+## [Subheading for Key Topic 2]
+
+[2-3 paragraphs on the second takeaway.]
+
+## [Subheading for Key Topic 3 (optional)]
+
+[1-2 paragraphs on a third point if warranted.]
+
+## Key Takeaways
+
+- [Takeaway 1 — stated as an actionable insight]
+- [Takeaway 2]
+
+- [Takeaway 3]
+
+---
+
+*Listen to the full conversation with [Guest Name] on [Podcast Name]:
+
+[Episode Link]*
+
+```
+
+**Rules:**
+
+- Title should be SEO-friendly and curiosity-driven (not just the episode name)
+- Subheadings break up the text every 200-300 words
+
+- Include 1-2 pull quotes as blockquotes
+- End with a bulleted takeaway section for skimmers
+
+- Final CTA links to the episode
+
+## Email Newsletter Template
+
+Subject line + preview text + body. Designed for high open rates and click-through.
+
+```text
+
+Subject: [Curiosity-driven, under 50 chars]
+
+Preview: [Complements subject, under 90 chars]
+
+---
+
+Hey [FirstName],
+
+[1-2 sentence hook — why should the reader care about this episode RIGHT NOW?
+
+Tie to a current trend, common frustration, or timely question.]
+
+This week on [Podcast Name], [Guest Name] shared [brief description of the
+
+conversation's focus — 1 sentence].
+
+Here's what stood out:
+
+**[Insight 1 headline]**
+
+[2-3 sentences expanding]
+
+**[Insight 2 headline]**
+
+[2-3 sentences expanding]
+
+> "[Pull quote]" — [Speaker]
+
+[CTA Button: "Listen to the Full Episode →"]
+
+[Optional: 1-sentence personal note or teaser for next episode]
+
+[Sign-off]
+
+```
+
+**Subject line patterns that work:**
+
+- Question format: "Is [common practice] actually hurting you?"
+- Contrarian: "[Guest] says we're all wrong about [topic]"
+
+- Curiosity gap: "The one thing [experts] won't tell you about [topic]"
+- Direct value: "3 [topic] lessons from [Guest Name]"
+
+## Show Notes Template
+
+Structured for podcast hosting platforms and websites.
+
+```markdown
+
+# [Episode Title]
+
+**Episode [Number] | [Date] | [Duration]**
+
+[1-paragraph episode description — what the listener will learn and why it
+
+matters. Written in second person: "you'll discover...", "you'll learn..."]
+
+## Guest
+
+[Guest Name] — [1-2 sentence bio with credentials and relevant links]
+
+## Timestamps
+
+- [00:00] Introduction and guest background
+- [03:15] [Topic 1]
+
+- [12:40] [Topic 2]
+- [25:00] [Topic 3]
+
+- [38:20] Key takeaways and rapid-fire questions
+- [45:00] Where to find [Guest Name]
+
+## Key Takeaways
+
+1. [Takeaway 1 — actionable, specific]
+2. [Takeaway 2]
+
+3. [Takeaway 3]
+
+## Links & Resources
+
+- [Resource mentioned in episode](url)
+- [Guest's website/social](url)
+
+- [Book/tool/article referenced](url)
+
+## Subscribe
+
+[Links to Apple Podcasts, Spotify, etc.]
+
+```
+
+## Pull Quotes Template
+
+Select quotes that work as standalone shareable graphics.
+
+**Selection criteria:**
+
+- Makes sense without any context
+- Surprising, insightful, or emotionally resonant
+
+- Under 150 characters (fits on a social graphic)
+- Attributable to a specific speaker
+
+**Format:**
+
+```text
+
+1. "[Quote text]" — [Speaker Name] | Timestamp: [HH:MM:SS]
+2. "[Quote text]" — [Speaker Name] | Timestamp: [HH:MM:SS]
+
+...
+
+```
+
+**Quote categories to look for:**
+
+- **Contrarian takes** — challenges popular beliefs
+- **Actionable advice** — specific, implementable tips
+
+- **Emotional moments** — vulnerability, humor, passion
+- **Sound bites** — catchy, memorable phrasing
+
+- **Data points** — surprising statistics or numbers mentioned

package/.local/secondary_skills/podcast-marketing/quote-cards.md

@@ -0,0 +1,238 @@
+# Quote Cards
+
+Generate visually appealing quote card images for social media from podcast pull quotes.
+
+## Table of Contents
+
+- [Design Specifications](#design-specifications)
+- [Output Dimensions](#output-dimensions)
+
+- [Generation Methods](#generation-methods)
+- [Text Layout Rules](#text-layout-rules)
+
+## Design Specifications
+
+Each quote card should include:
+
+1. **Quote text** — formatted for visual impact with line breaks at natural pauses
+2. **Speaker attribution** — name and title/role
+
+3. **Podcast branding** — show name or logo
+4. **Background** — gradient, solid color, or subtle pattern (not a busy photo)
+
+### Style Guidelines
+
+- **Typography**: Use a bold, readable font for the quote. Sans-serif for modern feel, serif for authority/editorial feel.
+- **Contrast**: Ensure strong contrast between text and background (WCAG AA minimum).
+
+- **Whitespace**: Generous margins (at least 10% of canvas on all sides). The quote should breathe.
+- **Hierarchy**: Quote text is largest, attribution is smaller, branding is smallest.
+
+- **Color**: Pull from the podcast's brand palette if available. If not, use the tone of the episode to guide color choice (warm tones for personal stories, cool tones for technical content, bold tones for controversial takes).
+
+## Output Dimensions
+
+Generate each quote card in three sizes:
+
+| Platform | Dimensions | Aspect Ratio | Use |
+
+|----------|-----------|-------------|-----|
+
+| Instagram Feed | 1080 x 1080 | 1:1 | Feed posts, carousels |
+
+| Twitter/LinkedIn | 1200 x 675 | 16:9 | Tweet images, LinkedIn posts |
+
+| Stories/Reels | 1080 x 1920 | 9:16 | Instagram Stories, TikTok |
+
+## Generation Methods
+
+### Method 1: Pillow (Python)
+
+Use Pillow for programmatic generation. Best for batch processing and consistent branding.
+
+```python
+
+from PIL import Image, ImageDraw, ImageFont
+
+import textwrap
+
+def generate_quote_card(
+
+quote_text: str,
+
+speaker_name: str,
+
+speaker_title: str,
+
+podcast_name: str,
+
+output_path: str,
+
+width: int = 1080,
+
+height: int = 1080,
+
+bg_color: str = "#1a1a2e",
+
+accent_color: str = "#e94560",
+
+text_color: str = "#ffffff",
+
+subtitle_color: str = "#a0a0b0",
+
+):
+
+img = Image.new("RGB", (width, height), bg_color)
+
+draw = ImageDraw.Draw(img)
+
+margin_x = int(width * 0.12)
+
+margin_y = int(height * 0.15)
+
+max_text_width = width - 2 * margin_x
+
+try:
+
+font_quote = ImageFont.truetype(
+
+"/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
+
+int(width * 0.042),
+
+)
+
+font_speaker = ImageFont.truetype(
+
+"/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+
+int(width * 0.028),
+
+)
+
+font_brand = ImageFont.truetype(
+
+"/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+
+int(width * 0.022),
+
+)
+
+except OSError:
+
+font_quote = ImageFont.load_default()
+
+font_speaker = font_quote
+
+font_brand = font_quote
+
+draw.text(
+
+(margin_x, margin_y - int(height * 0.08)),
+
+"\u201c",
+
+fill=accent_color,
+
+font=ImageFont.truetype(
+
+"/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
+
+int(width * 0.12),
+
+) if font_quote != ImageFont.load_default() else font_quote,
+
+)
+
+chars_per_line = int(max_text_width / (width * 0.025))
+
+wrapped = textwrap.fill(quote_text, width=chars_per_line)
+
+lines = wrapped.split("\n")
+
+y = margin_y + int(height * 0.05)
+
+line_height = int(width * 0.058)
+
+for line in lines:
+
+draw.text((margin_x, y), line, fill=text_color, font=font_quote)
+
+y += line_height
+
+y += int(height * 0.04)
+
+draw.line(
+
+[(margin_x, y), (margin_x + int(width * 0.08), y)],
+
+fill=accent_color,
+
+width=3,
+
+)
+
+y += int(height * 0.03)
+
+draw.text((margin_x, y), speaker_name, fill=text_color, font=font_speaker)
+
+y += int(height * 0.04)
+
+if speaker_title:
+
+draw.text(
+
+(margin_x, y), speaker_title, fill=subtitle_color, font=font_speaker
+
+)
+
+y += int(height * 0.04)
+
+brand_bbox = draw.textbbox((0, 0), podcast_name, font=font_brand)
+
+brand_width = brand_bbox[2] - brand_bbox[0]
+
+draw.text(
+
+(width - margin_x - brand_width, height - margin_y),
+
+podcast_name,
+
+fill=subtitle_color,
+
+font=font_brand,
+
+)
+
+img.save(output_path, quality=95)
+
+return output_path
+
+```
+
+### Method 2: AI Image Generation
+
+For higher visual quality, use the `generate_image` tool to create unique, branded quote card backgrounds, then overlay the text programmatically. This produces more visually distinctive cards but takes longer.
+
+Prompt pattern:
+
+```text
+
+Abstract background for a quote card. [Color palette description].
+
+Subtle gradient with soft geometric shapes. No text. Modern, clean, editorial feel.
+
+Dimensions: [width]x[height].
+
+```
+
+## Text Layout Rules
+
+- **Maximum quote length**: 150 characters for single-size cards. For longer quotes (up to 250 chars), reduce font size by 20%.
+- **Line breaks**: Break at natural pauses, not mid-phrase. Prioritize semantic breaks:
+
+- Good: "Culture eats strategy\nfor breakfast"
+- Bad: "Culture eats\nstrategy for breakfast"
+
+- **Emphasis**: Use ALL CAPS for one key word/phrase if the quote has a clear punchline. Don't overdo it.
+- **Attribution format**: "— Speaker Name" on one line, title/role on the next.