@aksp/opencrew 1.0.0

package/templates/_opencrew/core/best-practices/instagram-feed.md

@@ -0,0 +1,252 @@
+---
+name: "Instagram Feed Post"
+platform: "instagram"
+content_type: "feed"
+description: "Carousel and single image posts optimized for saves, shares, and feed engagement"
+whenToUse: |
+  Creating agents that produce Instagram feed posts, carousels, or static image content for Instagram.
+constraints:
+  caption_max_chars: 2200
+  caption_visible_chars: 125
+  max_hashtags: 30
+  recommended_hashtags: "5-15"
+  carousel_max_slides: 20
+  recommended_slides: "8-10"
+  min_words_per_slide: 40
+  max_words_per_slide: 80
+  image_ratio: "3:4 portrait"
+  image_resolution: "1080x1440px"
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. Write 40-80 words per carousel slide using a two-layer hierarchy (headline + supporting text).
+2. Choose a specific format (Editorial, Listicle, Tutorial, etc.) and follow its narrative arc.
+3. Front-load the most compelling value in the first 125 characters of the caption.
+4. Alternate background colors across slides to create visual rhythm.
+5. Highlight key phrases within headlines using an accent color.
+6. Design the cover slide to be a scroll-stopping hook with bold type and high contrast.
+7. End every slide with an implicit or explicit reason to swipe.
+8. Conclude captions and carousels with a specific, actionable CTA or open-ended question.
+9. Use 5-15 relevant hashtags mixed between niche, mid-range, and broad categories.
+10. Post consistently (4-7x/week) at optimal times (9-11 AM or 7-9 PM).
+11. Place hashtags at the end of the caption or in the first comment; avoid banned tags.
+12. Never place clickable URLs in Instagram captions.
+
+<!-- End Compact Rules. Full reference below. -->
+
+## Platform Rules
+
+- Engagement is weighted: Saves > Shares > Comments > Likes. Design content that is worth saving or sending to a friend.
+- Carousels receive approximately 1.4x more reach than single images. The algorithm re-serves carousels to users who did not swipe the first time, giving them a second chance at impressions.
+- Early engagement in the first 30-60 minutes strongly influences total distribution. Time your post for when your audience is most active.
+- Best posting times: 9-11 AM or 7-9 PM in your audience's local time zone. Tuesday, Wednesday, and Thursday tend to perform strongest.
+- Shares to DMs and Stories are the highest-value engagement signals for the algorithm.
+- Consistent posting cadence (4-7x/week) signals an active account and maintains algorithmic favor.
+
+## General Carousel Rules
+
+- Each slide uses **40–80 words** (unless the user explicitly requests shorter) with a **two-layer text hierarchy**: a large bold headline (primary claim) and a smaller supporting text (data, context, or elaboration). The minimum of 40 words ensures the slide is informative and not superficial.
+- Alternate background colors across slides (light, dark, accent) to create visual rhythm and prevent fatigue.
+- Highlight **key phrases** in an accent color (e.g., orange or red) within the headline text.
+- Place editorial-quality photos between text blocks — they illustrate the point, not decorate.
+- Maintain a consistent header bar across all slides (branding + handle + date).
+- Use a consistent visual template across slides for brand recognition.
+- The first slide is everything — it must stop the scroll with high contrast, bold type, and a clear promise or curiosity gap.
+
+## Carousel Formats
+
+Choose the format that best fits the content goal. Each format has a specific slide structure and narrative arc.
+
+---
+
+### 1. Editorial / Tese (8-10 slides)
+
+**Goal:** Argue a thesis with evidence. Builds authority, drives saves and shares.
+**Best for:** Trends, market analysis, contrarian takes, data-backed arguments.
+
+**Slide flow:**
+1. **Cover** — Photo + bold title overlay (provocative question or claim). Magazine-cover style with branding and date.
+2. **Context** — Headline states the core shift or trend. Photo. Supporting text introduces the tension or anchoring data.
+3. **Explanation slides (5-7)** — One argument, example, or data point per slide. Headline delivers the insight. Supporting text reinforces with evidence or real-world example.
+4. **Synthesis** — Headline ties everything into a concluding takeaway. Supporting text delivers the "so what."
+5. **Credits/CTA** — Photo + source attribution (article, study, or report) + CTA (comment keyword, save, share).
+
+---
+
+### 2. Listicle / Lista (8-10 slides)
+
+**Goal:** Deliver scannable, numbered value. Drives saves (reference material).
+**Best for:** Tips, tools, resources, recommendations, checklists.
+
+**Slide flow:**
+1. **Cover** — "X [coisas/dicas/ferramentas] para [resultado]". Bold number + clear promise.
+2. **Items (6-8 slides)** — One item per slide. Headline is the item name or tip (numbered). Supporting text explains the why or how in 1-2 sentences.
+3. **Recap/CTA** — Optional summary of all items in a visual checklist. CTA: "Salve para consultar depois" or "Mande para alguém que precisa."
+
+---
+
+### 3. Tutorial / Passo-a-passo (8-12 slides)
+
+**Goal:** Teach a process. Drives saves (people bookmark to follow later).
+**Best for:** How-to guides, recipes, setup guides, workflows.
+
+**Slide flow:**
+1. **Cover** — Show the finished result or outcome first. Bold title: "Como [resultado] em X passos."
+2. **Steps (6-10 slides)** — One step per slide. Headline: "Passo X: [ação]". Supporting text explains the detail. Use screenshots, diagrams, or process photos.
+3. **Result** — Show the final outcome again with a before/after or summary.
+4. **CTA** — "Salve esse tutorial" or "Comenta se deu certo."
+
+---
+
+### 4. Mito vs Realidade (6-10 slides)
+
+**Goal:** Bust misconceptions. Positions the brand as authority. Drives comments (debate).
+**Best for:** Industry myths, common mistakes, "what people think vs what actually works."
+
+**Slide flow:**
+1. **Cover** — "X mitos sobre [tema] que você ainda acredita." Bold, confrontational.
+2. **Myth/Reality pairs (4-8 slides)** — Each slide presents one myth (crossed out or in red) and the reality (in green or accent color). Headline is the myth. Supporting text is the correction with evidence.
+3. **Synthesis** — "O que realmente funciona é..." with a clear takeaway.
+4. **CTA** — "Qual mito te surpreendeu mais? Comenta abaixo."
+
+---
+
+### 5. Antes e Depois (6-8 slides)
+
+**Goal:** Show transformation. Drives engagement through visual proof and emotional impact.
+**Best for:** Results, case studies, redesigns, fitness, branding, portfolio.
+
+**Slide flow:**
+1. **Cover** — Teaser of the transformation. "De [estado ruim] para [estado bom]" or dramatic before/after split.
+2. **Before (1-2 slides)** — Show the problem state. Headline describes what was wrong. Supporting text gives context.
+3. **Process (2-3 slides)** — What changed and why. One key decision or action per slide.
+4. **After (1-2 slides)** — Show the result. Headline highlights the key metric or outcome.
+5. **CTA** — "Quer esse resultado? Link na bio" or "Salve para referência."
+
+---
+
+### 6. Storytelling / Narrativa (8-10 slides)
+
+**Goal:** Build emotional connection. Drives shares and comments through relatability.
+**Best for:** Personal stories, brand origin, customer journeys, lessons learned.
+
+**Slide flow:**
+1. **Cover** — Hook that creates curiosity. "Como eu [resultado surpreendente]" or "A história por trás de [X]."
+2. **Setup (1-2 slides)** — Set the scene. Who, where, when. Create empathy.
+3. **Conflict (2-3 slides)** — The challenge, mistake, or turning point. Build tension.
+4. **Resolution (2-3 slides)** — What happened, what was learned, how it changed everything.
+5. **Takeaway** — Universal lesson the audience can apply.
+6. **CTA** — "Você já passou por algo parecido?" or "Manda pra quem precisa ouvir isso."
+
+---
+
+### 7. Problema → Solução (6-10 slides)
+
+**Goal:** Directly address a pain point and present the solution. Drives saves and DM shares.
+**Best for:** Product positioning, service offers, common frustrations, "stop doing X, do Y instead."
+
+**Slide flow:**
+1. **Cover** — State the problem boldly. "Você ainda faz [erro comum]?" or "O problema que ninguém fala sobre [tema]."
+2. **Problem (2-3 slides)** — Describe the pain. One symptom or consequence per slide. Make the reader feel seen.
+3. **Bridge (1 slide)** — "Mas existe um jeito melhor" or "A solução é mais simples do que parece."
+4. **Solution (2-4 slides)** — Present the answer. One actionable point per slide.
+5. **Proof (optional)** — Data, testimonial, or result that validates the solution.
+6. **CTA** — "Salve e aplica hoje" or "Comenta [keyword] que eu te mando o guia."
+
+---
+
+### Single Image Post
+
+- Strong visual that communicates a single idea at a glance.
+- Works best for quotes, announcements, bold statements, and high-quality photography.
+- The caption carries the weight of the value delivery.
+
+## Writing Guidelines
+
+- **First 125 characters are critical.** They must compel the reader to tap "more." Front-load the value or curiosity gap.
+- Use line breaks aggressively for readability. Add periods or dashes as spacing characters between paragraphs.
+- Write the hook as a standalone statement that creates urgency, curiosity, or personal relevance.
+- End every caption with a question or clear CTA to drive comments.
+- Use 5-15 hashtags per post. Mix: 3-5 niche/specific + 3-5 mid-range (10K-500K posts) + 2-3 broad/popular.
+- Place hashtags at the end of the caption or in the first comment.
+- Rotate hashtag sets between posts. Never copy-paste the same block repeatedly.
+- Avoid banned or flagged hashtags — Instagram silently suppresses posts using them.
+
+## Output Format
+
+```
+=== FORMAT ===
+[Name of the chosen carousel format: Editorial, Listicle, Tutorial, Mito vs Realidade, Antes e Depois, Storytelling, or Problema → Solução]
+
+=== SLIDES ===
+Slide 1 (Cover):
+  Title: [Bold title overlay — max 20 words]
+  Photo: [Photo description/direction]
+  Background: [cover photo / solid color]
+
+Slide 2 ([Role]):
+  Headline: [Bold, large text — primary claim or point]
+  Photo: [Photo description, if applicable]
+  Supporting text: [Smaller text — data, context, or elaboration]
+  Accent keywords: [Words to highlight in accent color]
+  Background: [light/dark/accent]
+
+Slide 3 ([Role]):
+  Headline: [...]
+  Photo: [...]
+  Supporting text: [...]
+  Accent keywords: [...]
+  Background: [light/dark/accent]
+
+...continue until all slides are complete (min 40 words / max 80 words per slide, unless user requests shorter)...
+
+Slide N (CTA):
+  Photo: [Closing image]
+  Source: [Article, study, or report that inspired the content — if applicable]
+  CTA: [Specific action — comment keyword, save, share]
+
+=== CAPTION ===
+[Hook paragraph — must open with first 125 characters that compel "more" tap. Set the tension.]
+
+[Body paragraph — expanded argument with key points. Use line breaks for readability.]
+
+[Closing question — provocative, open-ended question that drives comments and reflection.]
+
+[AI disclosure if applicable.]
+
+=== HASHTAGS ===
+#hashtag1 #hashtag2 #hashtag3 #hashtag4 #hashtag5
+[5-15 hashtags, mix of niche, mid-range, and broad]
+```
+
+## Quality Criteria
+
+- [ ] Carousel format is explicitly chosen and follows the corresponding slide flow
+- [ ] Cover slide has a bold, provocative title (max 20 words) that stops the scroll
+- [ ] Each slide uses two-layer hierarchy: bold headline + smaller supporting text
+- [ ] Each slide has **at least 40 words** total (headline + supporting text combined) — unless the user explicitly requested shorter slides
+- [ ] Each slide stays within 80 words total (headline + supporting text combined)
+- [ ] Background colors alternate across slides (light, dark, accent) for visual rhythm
+- [ ] Key phrases are highlighted in accent color within headlines
+- [ ] Each slide advances the narrative — no filler or repetition between slides
+- [ ] Swipe-through rate is optimized: every slide ends with implicit or explicit reason to swipe
+- [ ] Caption first 125 characters work as a standalone hook
+- [ ] Caption ends with a provocative open-ended question or clear CTA
+- [ ] Hashtags are between 5-15, with a mix of niche and broad tags
+- [ ] No hashtag is banned or flagged by Instagram
+- [ ] Final slide includes a specific, actionable CTA (not generic "follow me")
+- [ ] Content is designed to be save-worthy or share-worthy, not just likeable
+
+## Anti-Patterns
+
+- **Links in captions** — Instagram captions do not support clickable links. Including URLs wastes characters and looks amateurish. Use bio link or Stories link sticker instead.
+- **Too little text per carousel slide** — Slides with fewer than 40 words are superficial and fail to deliver value. The supporting text layer must add real context, data, or explanation — not just restate the headline. Exception: user explicitly requests short/punchy slides.
+- **Too much text per carousel slide** — Exceeding 80 words per slide destroys readability. Use the two-layer hierarchy (headline + supporting text) to keep density manageable. Never put all text at the same size.
+- **No CTA** — Posts without a clear ask get saved and shared significantly less. Always tell the audience what to do next.
+- **Generic stock aesthetics** — Overly polished stock photos signal "advertisement" to users and reduce organic engagement.
+- **Hashtag spam** — Using all 30 hashtags or including irrelevant trending tags triggers algorithmic suppression.
+- **Editing captions after posting** — May reset the algorithmic distribution cycle, killing early momentum.
+- **Posting and ghosting** — Not responding to comments in the first hour signals low engagement to the algorithm and reduces reach.
+- **Inconsistent posting** — Gaps of 7+ days signal an inactive account to the algorithm, reducing baseline reach.

package/templates/_opencrew/core/best-practices/instagram-reels.md

@@ -0,0 +1,128 @@
+---
+name: "Instagram Reels"
+platform: "instagram"
+content_type: "reels"
+description: "Short-form vertical video optimized for discovery, watch time, and non-follower reach"
+whenToUse: |
+  Creating agents that produce Instagram Reels or short-form vertical video for Instagram.
+constraints:
+  max_duration_seconds: 90
+  recommended_duration: "15-30s"
+  aspect_ratio: "9:16 vertical"
+  caption_max_chars: 2200
+  caption_visible_chars: 125
+  max_hashtags: 30
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. Deliver a clear curiosity gap or value promise in the first 0-2 seconds (the hook).
+2. Keep Reel duration between 15-30 seconds to maximize completion rates and replays.
+3. Include burned-in subtitles/captions always; 85% of users watch without sound.
+4. Maintain visual variety with cuts, angle changes, or B-roll every 3-5 seconds.
+5. Shoot natively in 9:16 vertical format; never use letterboxed horizontal video.
+6. Design the ending to loop seamlessly back to the beginning to boost replay metrics.
+7. End with a specific, actionable CTA in the last 3-5 seconds (not a generic "follow me").
+8. Front-load the caption's value into the first 125 characters.
+9. Use 5-15 relevant hashtags and incorporate trending audio contextually.
+10. Post consistently 3-5 times a week to maintain algorithmic momentum.
+11. Avoid slow intros, logo reveals, or generic greetings like "hey guys".
+
+<!-- End Compact Rules. Full reference below. -->
+
+## Platform Rules
+
+- Reels are the primary discovery format on Instagram. They are shown to non-followers via the Explore page and the dedicated Reels tab, making them the strongest tool for audience growth.
+- Watch time is the dominant metric: completion rate and replays directly boost distribution. A 15-second Reel watched twice outperforms a 60-second Reel watched halfway.
+- Engagement weight for Reels: Shares > Saves > Comments > Likes. Shares to DMs and Stories carry the highest algorithmic value.
+- Reels can be posted at any time — algorithmic distribution is less time-dependent than feed posts, though early engagement still helps.
+- Trending audio boosts Explore placement. Using a currently trending sound gives a measurable bump in impressions.
+- Consistent Reels posting (3-5x/week) signals an active creator account and maintains algorithmic favor.
+
+## Content Structure
+
+### Reel Sequence
+
+1. **Hook (0-2 seconds)** — Text overlay or spoken hook that immediately creates curiosity or promises value. No slow intros, no logos, no "hey guys." The viewer decides to stay or swipe in this window.
+2. **Setup (2-5 seconds)** — Quick context establishing what the Reel is about and why the viewer should care. Keep it tight.
+3. **Delivery (5-60 seconds)** — The core value: tutorial steps, story beats, entertainment, or insight. Maintain visual variety with cuts, angles, or B-roll every 3-5 seconds.
+4. **CTA (last 3-5 seconds)** — Direct ask: follow for more, comment your answer, share with someone who needs this. Keep it short and specific.
+
+### Loop Design
+
+- Design the ending to visually or narratively connect back to the beginning. A seamless loop encourages replays, which are one of the strongest algorithmic signals.
+- Common loop techniques: ending mid-sentence and starting with the same word, visual match cuts, circular storytelling.
+
+## Writing Guidelines
+
+- **Hook must be immediate.** The first 1-2 seconds determine whether the viewer stays. Use text overlays that pose a question, make a bold claim, or tease a reveal.
+- Write spoken scripts at a conversational pace. Aim for 130-150 words per minute of content.
+- Keep Reels between 15-30 seconds for maximum completion rate. Shorter Reels have higher replay potential.
+- Add captions/subtitles to every Reel. 85% of Instagram users watch without sound. Burned-in subtitles are non-negotiable.
+- Caption (below the Reel): front-load the value in the first 125 visible characters. Expand with context, then add hashtags.
+- Use trending audio when it fits your content naturally. Forced trending audio with no connection to the content feels inauthentic.
+- End with a specific CTA, not a generic "follow me." Ask a question, prompt a share, or direct to another piece of content.
+
+## Output Format
+
+```
+=== REEL SCRIPT ===
+
+HOOK (0-2s):
+[Visual]: [What appears on screen — text overlay, action, scene]
+[Audio]: [Spoken words, trending sound, or music cue]
+[Text Overlay]: [On-screen text that hooks the viewer — max 10 words]
+
+SETUP (2-5s):
+[Visual]: [Scene or transition establishing context]
+[Script]: [Spoken setup — 1-2 sentences max]
+
+DELIVERY (5-60s):
+[Visual]: [Shot-by-shot breakdown with cuts every 3-5 seconds]
+[Script]: [Full spoken script for the delivery section]
+[Text Overlays]: [Key points highlighted on screen]
+
+CTA (last 3-5s):
+[Visual]: [Final frame or gesture]
+[Script]: [Spoken CTA — one specific ask]
+[Text Overlay]: [CTA text on screen]
+
+=== CAPTION ===
+[Hook line — must fit in 125 characters]
+
+[Expanded context or value — 2-3 short lines]
+
+[CTA — question or action prompt]
+
+=== HASHTAGS ===
+#hashtag1 #hashtag2 #hashtag3 #hashtag4 #hashtag5
+[5-15 hashtags, relevant to the content topic]
+
+=== AUDIO NOTE ===
+[Trending sound suggestion or original audio direction]
+```
+
+## Quality Criteria
+
+- [ ] Hook delivers a clear curiosity gap or value promise within the first 2 seconds
+- [ ] Total duration is between 15-30 seconds for optimal completion rate
+- [ ] Script includes burned-in subtitles/captions for sound-off viewing
+- [ ] Visual variety is present — cuts or angle changes every 3-5 seconds
+- [ ] Ending is designed for loop potential (visual or narrative connection to the start)
+- [ ] CTA is specific and actionable, not generic
+- [ ] Caption first 125 characters work as a standalone hook
+- [ ] Audio direction is specified (trending sound or original audio)
+- [ ] Aspect ratio is 9:16 vertical — no horizontal or square content
+- [ ] Content delivers on the hook's promise (no bait-and-switch)
+
+## Anti-Patterns
+
+- **Landscape video as Reels** — Horizontal video cropped into 9:16 wastes screen real estate and looks unintentional. Always shoot natively vertical.
+- **No subtitles on Reels** — 85% of users watch without sound. A Reel without captions loses the majority of its potential audience.
+- **Slow intros** — Starting with a logo reveal, "hey guys," or any non-hook content causes immediate swipe-away. Hook first, always.
+- **No CTA** — Reels without a clear ask generate significantly fewer follows, saves, and shares. Always direct the viewer's next action.
+- **Posting and ghosting** — Not engaging with comments in the first hour reduces the Reel's algorithmic momentum.
+- **Generic stock aesthetics** — Overly polished, impersonal content signals "ad" and reduces organic reach.
+- **Hashtag spam** — Using 30 irrelevant hashtags triggers suppression. Stick to 5-15 relevant tags.
+- **Forced trending audio** — Using a trending sound that has no connection to the content feels inauthentic and does not boost performance the way contextually relevant audio does.

package/templates/_opencrew/core/best-practices/instagram-stories.md

@@ -0,0 +1,123 @@
+---
+name: "Instagram Stories"
+platform: "instagram"
+content_type: "stories"
+description: "Ephemeral 24-hour vertical content with interactive elements for audience engagement and retention"
+whenToUse: |
+  Creating agents that produce Instagram Stories or ephemeral 24-hour content.
+constraints:
+  max_duration_seconds: 60
+  aspect_ratio: "9:16 vertical"
+  format: "ephemeral (24h)"
+  interactive_elements: "polls, questions, links, stickers, quizzes"
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. Structure Stories in sequences of 3-7 vertical (9:16) frames that follow a narrative arc.
+2. Grab attention in the first 2 seconds of the opener frame.
+3. Keep text extremely short: maximum 2-3 lines of large, readable font per frame.
+4. Ensure each frame can be consumed within 3-5 seconds without pausing.
+5. Include at least one interactive element (poll, question, quiz, slider) per sequence.
+6. Use specific, binary prompts for interactive elements rather than vague questions.
+7. Maintain a casual, conversational, and immediate tone.
+8. Add clear context text when using a link sticker to explain why the user should tap.
+9. Avoid walls of text; break long messages across multiple frames.
+10. Never repurpose horizontal content with black bars; always create vertical-native media.
+11. Do not use hashtags or formal caption structures in Stories.
+
+<!-- End Compact Rules. Full reference below. -->
+
+## Platform Rules
+
+- Stories are ephemeral and disappear after 24 hours. This creates urgency and encourages immediate viewing. High-performing Stories can be saved to Highlights for permanent access.
+- Stories appear at the top of the feed in the Stories bar. Posting multiple times throughout the day keeps your profile at the front of the bar, maintaining visibility.
+- Story engagement (replies, sticker interactions, poll votes) signals account relevance to the algorithm, which in turn boosts your feed post and Reel distribution.
+- Stories are shown primarily to existing followers, not new audiences. They are a retention and deepening tool, not a discovery tool.
+- Interactive elements (polls, questions, quizzes, sliders) dramatically increase engagement rate and time spent on your Stories.
+- Link stickers are the only way to share clickable links on Instagram (outside of bio). Use them strategically to drive traffic.
+
+## Content Structure
+
+### Story Sequence Design
+
+Stories work best as short sequences of 3-7 frames that follow a narrative arc. Each frame should be consumable in 3-5 seconds.
+
+1. **Opener frame** — Grab attention with a bold statement, question, or visually striking image. This determines whether viewers watch the rest of the sequence.
+2. **Context frames (1-3)** — Build the story, share the insight, or present the information. Keep text short and use visual hierarchy.
+3. **Interactive frame** — Deploy a poll, question box, quiz, or slider to transform passive viewers into active participants.
+4. **Closer frame** — Deliver the conclusion, payoff, or CTA. Link sticker if driving traffic. "DM me" or "Reply to this" for conversation.
+
+### Frame Types
+
+- **Text-on-background**: Bold text with a colored background. Best for announcements, questions, or quick thoughts.
+- **Photo/video with overlay**: Visual content with text overlay and optional stickers. The primary Story format.
+- **Interactive**: Frames built around a poll, quiz, question box, or emoji slider as the central element.
+- **Link frame**: Frame with a link sticker driving to an external URL. Must include clear context for why the viewer should tap.
+
+## Writing Guidelines
+
+- **Keep text extremely short.** Stories are consumed in seconds. 2-3 lines of large text maximum per frame. If it takes more than 3 seconds to read, it is too long.
+- Use a casual, conversational tone. Stories are the most informal format on Instagram. First person, contractions, and casual language are expected.
+- Write text overlays in large, bold fonts. Small text is unreadable on mobile and gets ignored.
+- Every interactive element needs a clear, specific prompt. "What do you think?" is weak. "Which would you choose: A or B?" is strong.
+- Use polls and quizzes to segment your audience and gather feedback. The responses provide content ideas and audience insights.
+- Questions boxes should ask something genuinely interesting that viewers want to answer. Generic prompts get ignored.
+- When using link stickers, always add context text explaining what the link is and why they should tap. A bare link sticker with no context gets minimal taps.
+- Stories do not use hashtags or formal caption structure. The tone is raw and immediate.
+
+## Output Format
+
+```
+=== STORY SEQUENCE ===
+
+FRAME 1 (Opener):
+[Visual]: [Photo/video description or background color]
+[Text Overlay]: [Bold hook text — max 2 lines, large font]
+[Sticker/Element]: [None / Music / Location / Mention]
+
+FRAME 2 (Context):
+[Visual]: [Photo/video description]
+[Text Overlay]: [Supporting context — max 3 lines]
+[Sticker/Element]: [Optional element]
+
+FRAME 3 (Interactive):
+[Visual]: [Background or supporting visual]
+[Text Overlay]: [Prompt text leading into the interactive element]
+[Interactive Element]: [Poll: "Option A" vs "Option B" / Quiz: "Question?" with answers / Question Box: "Ask me about..." / Emoji Slider: "How much do you [X]?"]
+
+FRAME 4 (Closer/CTA):
+[Visual]: [Final visual]
+[Text Overlay]: [Conclusion, payoff, or CTA text — max 2 lines]
+[Sticker/Element]: [Link sticker with URL / "DM me" prompt / Countdown sticker]
+
+=== SEQUENCE NOTES ===
+Total frames: [3-7]
+Estimated view time: [X seconds total]
+Primary goal: [Engagement / Traffic / Feedback / Announcement]
+```
+
+## Quality Criteria
+
+- [ ] Sequence is 3-7 frames long (not too short to have impact, not too long to cause drop-off)
+- [ ] Opener frame grabs attention within 2 seconds with a visual or textual hook
+- [ ] Text overlays are 2-3 lines maximum per frame with large, readable font
+- [ ] At least one frame includes an interactive element (poll, quiz, question, or slider)
+- [ ] Interactive prompts are specific and binary/concrete, not vague or open-ended
+- [ ] Tone is casual and conversational, matching the ephemeral nature of Stories
+- [ ] Link stickers (if used) include context text explaining what the link is and why to tap
+- [ ] Each frame is consumable in 3-5 seconds without pausing
+- [ ] Sequence follows a narrative arc (opener, context, interaction, closer)
+- [ ] Content is vertical-native (9:16), not adapted from horizontal content
+
+## Anti-Patterns
+
+- **Wall of text on a single frame** — Stories are consumed in seconds. More than 3 lines of text causes viewers to skip forward or exit. Break long messages across multiple frames.
+- **No interactive elements** — Stories without polls, questions, or quizzes miss the primary engagement mechanism of the format. Passive-only Stories get lower completion rates.
+- **Link sticker with no context** — A bare link sticker without text explaining what it leads to and why the viewer should tap gets minimal click-through.
+- **Posting one Story per day** — A single frame does not stay at the top of the Stories bar. Post 3-7 frames per sequence to maintain visibility.
+- **Repurposing feed posts as Stories** — Screenshotting a carousel slide or resharing a feed post without adding new value feels lazy. Add commentary, behind-the-scenes context, or an interactive element.
+- **Horizontal content in Stories** — Landscape photos or videos with black bars above and below waste screen space and look unintentional.
+- **Generic question prompts** — "Any questions?" or "What do you think?" are too vague to generate responses. Be specific: "What is your biggest challenge with X?"
+- **Ignoring Story replies** — Story replies are high-intent DMs. Not responding kills future engagement and signals disinterest to your audience.

package/templates/_opencrew/core/best-practices/linkedin-article.md

@@ -0,0 +1,133 @@
+---
+name: "LinkedIn Article"
+platform: "linkedin"
+content_type: "article"
+description: "Long-form blog-style content optimized for SEO, thought leadership, and evergreen professional value"
+whenToUse: |
+  Creating agents that produce LinkedIn articles or long-form professional content.
+constraints:
+  optimal_word_count: "1500-2000"
+  headline_max_chars: 220
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. Front-load the primary keyword in the headline within the first 70 characters (max 220).
+2. Use custom, high-quality cover images; never use generic stock photography.
+3. Hook the reader in the first 2-3 sentences of the introduction (this appears in feed preview).
+4. Organize content into 3-5 body sections with clear H2 subheadings.
+5. Provide at least one concrete data point, case study, or example per section.
+6. End each section with a specific, actionable takeaway.
+7. Synthesize a single memorable insight in the conclusion (100-200 words).
+8. Close with exactly one primary CTA (e.g., a question or link to related content).
+9. Write in the first person to establish authority ("In my experience").
+10. Keep total length between 1,500-2,000 words.
+11. Restrict paragraphs to 2-4 sentences to avoid reader fatigue.
+12. Always share the published article as a standard post using the "link in comments" strategy.
+
+<!-- End Compact Rules. Full reference below. -->
+
+## Platform Rules
+
+- LinkedIn Articles have lower immediate feed reach than posts but offer stronger long-term SEO value. Articles are indexed by search engines and remain discoverable indefinitely.
+- Articles appear on your profile under the "Activity" section and can be featured in the "Featured" section for permanent visibility.
+- The algorithm distributes articles primarily to your existing network. To maximize reach, share the article as a post with a compelling hook and "Link in comments" approach.
+- Articles support rich formatting: headers, images, embedded media, block quotes, and numbered lists. Use these to increase dwell time and readability.
+- Commenting and engagement on articles still matter. The first 60 minutes of engagement influence how broadly the article is distributed in the LinkedIn feed.
+- Articles can be published as part of a LinkedIn Newsletter, which pushes notifications to subscribers and dramatically increases consistent readership.
+- Best publishing days: Tuesday, Wednesday, Thursday during business hours (7-9 AM or 12-1 PM in your audience's time zone).
+
+## Content Structure
+
+### Article Architecture
+
+1. **Headline** — SEO-friendly, specific, and curiosity-driven. Front-load the primary keyword within the first 70 characters. Maximum 220 characters, but 60-100 characters is optimal for display.
+2. **Cover image** — High-quality, relevant visual. Avoid generic stock photos. Custom graphics or contextual images perform better.
+3. **Introduction (150-250 words)** — State the problem, establish relevance, and preview what the reader will learn. The first 2-3 sentences must hook the reader — they appear as the article preview in the feed.
+4. **Body sections (3-5 sections, 250-400 words each)** — Each section addresses one sub-topic with a clear subheading. Use a mix of narrative, data, and practical advice.
+5. **Actionable takeaways** — Each body section should end with a concrete, implementable takeaway. Readers should be able to act on the advice immediately.
+6. **Conclusion (100-200 words)** — Synthesize the key message into a single memorable insight. Reinforce the transformation or shift in thinking.
+7. **CTA** — End with a question that invites comments, a prompt to share, or a direction to related content.
+
+### Section Design
+
+- Use H2 subheadings for major sections and H3 for sub-points. Clear hierarchy helps both readability and SEO.
+- Include at least one data point, case study, or concrete example per section. Abstract advice without evidence is forgettable.
+- Use bullet points and numbered lists for scannable content within sections.
+- Keep paragraphs to 2-4 sentences maximum. Long paragraphs cause reader fatigue on screen.
+
+## Writing Guidelines
+
+- **Write in first person.** Personal experience and professional expertise are what give LinkedIn Articles authority. "In my experience" is more compelling than "It is generally recommended."
+- **Headline must balance SEO and curiosity.** Include the primary keyword naturally. Good: "Why Most B2B Content Strategies Fail (And 5 Ways to Fix Yours)." Bad: "Thoughts on Marketing."
+- Front-load value in the introduction. The first 2-3 sentences appear as the article preview in the LinkedIn feed. They must create a compelling reason to click through.
+- Use subheadings that are informative, not clever. "How to Structure Your First 90 Days" is better than "The Beginning." Readers scan subheadings to decide whether to read the full article.
+- Every section should answer the question "So what?" Give the reader a reason to care and something to do with the information.
+- Include specific numbers, frameworks, or step-by-step processes. Vague advice ("be more strategic") is worthless. Specific advice ("allocate 30% of your budget to X, track Y metric weekly") is actionable.
+- Close with a single, strong CTA. Do not scatter multiple calls to action throughout. One ask at the end: a question, a share prompt, or a link to related content.
+- Keep total length between 1,500-2,000 words. Under 1,000 feels thin for an article format. Over 2,500 causes completion rate drop-off.
+
+## Output Format
+
+```
+=== HEADLINE ===
+[SEO-optimized headline — 60-100 characters optimal, max 220. Front-load primary keyword.]
+
+=== COVER IMAGE ===
+[Description of the cover image concept — relevant, not generic stock]
+
+=== INTRO ===
+[Opening hook — 2-3 sentences that create urgency or curiosity]
+
+[Problem statement — what challenge or gap this article addresses]
+
+[Preview — what the reader will learn or gain by reading]
+
+=== SECTION 1: [Subheading] ===
+[Narrative, data, or example — 250-400 words]
+[Concrete takeaway from this section]
+
+=== SECTION 2: [Subheading] ===
+[Narrative, data, or example — 250-400 words]
+[Concrete takeaway from this section]
+
+=== SECTION 3: [Subheading] ===
+[Narrative, data, or example — 250-400 words]
+[Concrete takeaway from this section]
+
+=== SECTION 4: [Subheading] (optional) ===
+[Narrative, data, or example — 250-400 words]
+[Concrete takeaway from this section]
+
+=== CONCLUSION ===
+[Synthesis — the single most important insight from the article, 100-200 words]
+
+=== CTA ===
+[One clear call to action — question for comments, share prompt, or link to related content]
+```
+
+## Quality Criteria
+
+- [ ] Headline is 60-100 characters, front-loads the primary keyword, and creates curiosity
+- [ ] Introduction establishes the problem and previews the article's value within the first 3 sentences
+- [ ] Article contains 3-5 body sections, each with a clear H2 subheading
+- [ ] Each section includes at least one concrete example, data point, or case study
+- [ ] Each section ends with an actionable takeaway the reader can implement
+- [ ] Total word count is between 1,500-2,000 words
+- [ ] Paragraphs are 2-4 sentences maximum
+- [ ] Article is written in first person with professional authority
+- [ ] Conclusion synthesizes one memorable insight, not just a summary of points
+- [ ] CTA is a single, clear ask at the end of the article
+
+## Anti-Patterns
+
+- **Vague, keyword-stuffed headlines** — "Thoughts on Innovation and Digital Transformation in 2024" says nothing specific and will be ignored. Headlines must promise a concrete benefit or insight.
+- **No subheadings** — Long-form content without visual hierarchy is a wall of text. Readers scan subheadings to decide whether to invest time reading.
+- **Abstract advice without evidence** — "Be more strategic" or "Focus on value" without specific examples, data, or frameworks is forgettable and unactionable.
+- **Corporate jargon** — "Leveraging synergies to drive holistic transformation" alienates readers. Write in plain, direct language.
+- **Burying the value** — If the most useful insight is in paragraph 12, most readers will never reach it. Front-load value and structure for scanning.
+- **Multiple scattered CTAs** — Asking readers to like, share, comment, subscribe, visit your website, and download a PDF dilutes every ask. Pick one primary CTA.
+- **Generic stock cover images** — A handshake photo or a lightbulb clipart signals low effort. Use a relevant, custom visual.
+- **Under 1,000 words** — An article that is too short feels like it should have been a post. The article format implies depth and substance.
+- **No line breaks or formatting** — Dense paragraphs of 6+ sentences cause reader fatigue. Use short paragraphs, bullets, and whitespace.