code-ai-installer 1.5.6 → 2.0.1

package/domains/content/locales/en/.agents/skills/competitor-content-analysis/SKILL.md

@@ -0,0 +1,225 @@
+---
+name: competitor-content-analysis
+description: Deep analysis of competitor content — content mix, funnel, ER, gaps, comparative matrix, recommendations for differentiation
+---
+# Competitor Content Analysis 
+
+## When to use
+- During **content strategy development** — prior to `$content-calendar` and `$platform-strategy`.
+- When **entering a new platform** — understanding what works for competitors on this channel.
+- Upon a **drop in metrics** — finding out what competitors do better.
+- During **quarterly/monthly review** — updating the competitive landscape.
+
+## Input
+
+| Field | Required | Description |
+|------|:-----------:|----------|
+| Brand / product | ✅ | Whose content is analyzed in comparison (our brand) |
+| Niche / industry | ✅ | To search for competitors if none are supplied |
+| Competitor list | ⬚ | 3-5 competitors. If unsupplied — agent proposes and agrees with the user |
+| Platforms for analysis | ⬚ | If unspecified — derived from `$platform-strategy` or determined by competitor presence |
+| Analysis period | ⬚ | Default 30 days. Adapt: seasonal business → 90 days, launch → 14 days |
+| Existing analytics | ⬚ | The brand's own metrics for comparison (ER, reach, frequency) |
+
+> If competitors are not provided — the agent proposes a list by criteria: **direct** (same product, same TA), **indirect** (different product, same pain point), **aspirational** (niche leaders we aspire to). The list must be **approved by the user** before starting the analysis.
+
+## Data Sources and Methodology
+
+### Where to gather data
+1. **Social networks directly** — competitor profiles: feed, stories, reels, highlights, pinned posts.
+2. **Web search** — competitor blogs, guest posts, PR, YouTube.
+3. **Comments and reviews** — what the audience says under competitor posts.
+4. **Tools** (if user access is granted) — SimilarWeb, SEMrush, Social Blade, Brand24.
+5. **Telegram channels** — content, reposts, reactions.
+
+### ER (Engagement Rate) Formula
+Use a uniform formula to ensure a valid comparison:
+
+```
+ER (%) = (Likes + Comments + Reposts + Saves) / Followers × 100
+```
+
+- If exact data is unavailable — use an **estimation** marked with `≈` and indicate the method (visual estimation, sampling N posts).
+- For Telegram: `ER = Views / Subscribers × 100` (reactions as a bonus).
+- For YouTube: `ER = (Likes + Comments) / Views × 100`.
+
+## Protocol
+
+### Step 0 — Preparation
+1. Obtain all mandatory input data.
+2. If competitors are missing — propose 3-5 by criteria (direct / indirect / aspirational) and get approval.
+3. Define the analysis period (adapt to context).
+4. Identify platforms for analysis.
+
+### Step 1 — Profile of each competitor
+For each competitor, collect:
+1. Presence platforms and audience size on each.
+2. Publishing frequency (posts/week per platform).
+3. Top-5 posts by engagement over the period — log the topic, format, ER.
+4. ToV and visual style — description + 2-3 characteristic examples.
+5. ER — via formula or estimation (indicate method).
+
+### Step 2 — Content Mix
+Determine the proportions of content types for each competitor:
+
+| Type | Description |
+|-----|----------|
+| Educational | How-to, tips, breakdowns, guides |
+| Sales | Offers, case studies, reviews, demos |
+| Entertainment | Memes, trends, interactive |
+| Brand / Image | Mission, team, behind the scenes, values |
+| Community | UGC, questions, polls, Q&A |
+
+Record rough % splits and identify which type yields the best ER.
+
+### Step 3 — Funnel Analysis
+Assess how competitors cover the funnel stages with content:
+
+| Stage | Goal | Content Examples |
+|------|------|------------------|
+| **TOFU** (Awareness) | Capture attention | Viral content, trends, broad topics |
+| **MOFU** (Consideration) | Build trust | Case studies, comparisons, expert content |
+| **BOFU** (Decision) | Convert | Offers, demos, reviews, CTA |
+
+Determine: which stages are oversaturated and which are empty (gaps).
+
+### Step 4 — Gaps and Opportunities
+1. **Content gaps** — topics that no competitor covers, or covers poorly.
+2. **Format gaps** — formats not utilized (podcasts, carousels, threads, etc.).
+3. **Funnel gaps** — funnel stages lacking content.
+4. **Platform gaps** — platforms where competitors are absent but the TA exists.
+5. **ToV gaps** — an unoccupied tone (e.g., everyone is serious → opportunity for humor).
+
+### Step 5 — Comparative Matrix
+Assemble a side-by-side comparison of all competitors + our brand (if data exists):
+- Audience, frequency, ER, content mix, funnel, ToV.
+- Visually highlight where our brand is stronger / weaker.
+
+### Step 6 — Differentiation Recommendations
+Based on gaps and the matrix — 3-5 specific actionable recommendations:
+- What to do (format, topic, platform).
+- Why it will work (gap + data).
+- Priority (High / Medium / Low).
+
+## Validation (Quality Gate)
+
+The analysis is considered complete if:
+
+- [ ] 3-5 competitors analyzed (approved by the user)
+- [ ] For each competitor: profile, top-5 posts, ER, ToV
+- [ ] Content mix is defined for each competitor (% by type)
+- [ ] Funnel analyzed (TOFU / MOFU / BOFU coverage)
+- [ ] Gaps identified across at least 2 categories (content, format, funnel, platform, ToV)
+- [ ] Comparative matrix includes all competitors
+- [ ] Recommendations are specific and actionable (3-5 items with priorities)
+- [ ] All ERs calculated by a single formula or marked as `≈ estimation`
+- [ ] No confirmation bias — competitor strengths are also recorded
+
+## Handoff
+
+The result of this skill serves as input for:
+
+| Consumer | How it's used |
+|-------------|---------------|
+| `$platform-strategy` | Platform gaps → channel selection |
+| `$content-calendar` | Topic and format gaps → content planning |
+| `$audience-analysis` | Competitor audience → refining personas |
+| `$tone-of-voice` | ToV gaps → picking an unoccupied tone |
+| `$content-brief` | Recommendations → specific content briefs |
+
+When handing off — use `$handoff` attaching the comparative matrix and the top-3 recommendations.
+
+## Anti-patterns
+
+| Error | Why it's bad | How to do it right |
+|--------|-------------|---------------|
+| Analysis without approving the competitor list | You might analyze irrelevant ones | Agree with the user prior to starting |
+| Confirmation bias | Hunting only for competitor weaknesses | Record their strengths too |
+| Surface scrolling | "They post memes" — not an analysis | Top-5 posts, ER, content mix in % |
+| Mismatched periods | Competitor A over 30 days vs B over 7 | Unified period for everyone |
+| ER without methodology | "Engagement is high" — subjective | Unified formula, numbers, method |
+| Only one competitor | Fails to show the market picture | Minimum 3 to detect patterns |
+| Recommendations without data | "We need more reels" — why? | Every recommendation is tied to a specific gap |
+
+## Output Template
+
+```
+### Competitor Analysis — [Niche / Brand]
+
+**Period:** [start date] — [end date] ([N days])
+**Platforms:** [list]
+**Data sources:** [how collected — manually / tools]
+**ER method:** [formula]
+
+---
+
+#### Competitor 1: [Name]
+- **Type:** [direct / indirect / aspirational]
+- **Platforms and audience:**
+  | Platform | Followers | Frequency (posts/wk) | ER |
+  |-----------|------------|--------------------|----|
+  | [platform] | [number] | [number] | [%] |
+
+- **Top-5 posts:**
+  | # | Platform | Topic | Format | ER | Why it worked |
+  |---|-----------|------|--------|----|-----------------|
+  | 1 | [platform] | [topic] | [format] | [%] | [reason] |
+
+- **Content mix:**
+  | Type | % | ER of this type | Example |
+  |-----|---|---------------|--------|
+  | Educational | [%] | [%] | [example] |
+  | Sales | [%] | [%] | [example] |
+  | Entertainment | [%] | [%] | [example] |
+  | Image | [%] | [%] | [example] |
+  | Community | [%] | [%] | [example] |
+
+- **Funnel:** TOFU [strong/medium/weak] · MOFU [strong/medium/weak] · BOFU [strong/medium/weak]
+- **ToV:** [description + 2-3 characteristic examples]
+- **Visual style:** [description]
+- **Strengths:** [list]
+- **Weaknesses:** [list]
+
+---
+
+#### Competitor 2: [Name]
+[Similar structure]
+
+---
+
+### Comparative Matrix
+
+| Metric | [Our brand] | [Competitor 1] | [Competitor 2] | [Competitor 3] |
+|---------|-------------|---------------|---------------|---------------|
+| Followers (main platform) | [number] | [number] | [number] | [number] |
+| Frequency (posts/wk) | [number] | [number] | [number] | [number] |
+| ER | [%] | [%] | [%] | [%] |
+| Dominant format | [format] | [format] | [format] | [format] |
+| Content mix (leading type) | [type] | [type] | [type] | [type] |
+| Funnel (strongest stage) | [stage] | [stage] | [stage] | [stage] |
+| ToV | [description] | [description] | [description] | [description] |
+
+---
+
+### Gaps and Opportunities
+
+| # | Gap type | Description | Opportunity for us | Priority |
+|---|---------|----------|---------------------|-----------|
+| 1 | Content | [topic uncovered] | [how to leverage] | High |
+| 2 | Format | [format unused] | [how to leverage] | Medium |
+| 3 | Funnel | [stage sans content] | [how to fill it] | High |
+| 4 | Platform | [platform without presence] | [how to claim it] | Low |
+| 5 | ToV | [tone unoccupied] | [how to differentiate] | Medium |
+
+---
+
+### Differentiation Recommendations
+
+| # | Recommendation | Based on gap | Why it will work | Priority |
+|---|-------------|---------------|------------------|-----------|
+| 1 | [what to do] | Gap #[N] | [data / logic] | High |
+| 2 | [what to do] | Gap #[N] | [data / logic] | High |
+| 3 | [what to do] | Gap #[N] | [data / logic] | Medium |
+
+**→ Next step:** hand over to `$platform-strategy` (channel selection) and `$content-calendar` (topic planning)
+```

package/domains/content/locales/en/.agents/skills/content-brief/SKILL.md

@@ -0,0 +1,230 @@
+---
+name: content-brief
+description: Complete brief for a unit of content — goal, persona, key points, SEO, visuals, references, distribution, metrics
+---
+# Content Brief 
+
+## When to use
+- When **handing off a task** from Strategist to Researcher / Copywriter / Visual Concept.
+- During **content planning** — each unit from `$content-calendar` gets its own brief.
+- During **recreation / updating** of existing content (rewrite, repurpose).
+
+## Input
+
+| Field | Required | Description |
+|------|:-----------:|----------|
+| Topic / idea | ✅ | What the content is about — from `$content-calendar`, user assignment, or Strategist |
+| TA Persona | ✅ | Specifically targeted persona from `$audience-analysis` |
+| Platform | ✅ | From `$platform-strategy` — where it will be published |
+| Format | ✅ | Post, article, reel, carousel, email, video, etc. |
+| Brand guidelines | ✅ | From `$brand-guidelines` — ToV, visual standards |
+| Publication date | ⬚ | From `$content-calendar` or the user |
+| SEO data | ⬚ | Keywords, search intent (for text formats: article, blog, landing) |
+| References | ⬚ | Content examples (own / competitor / from other niches) |
+
+> If persona or platform is unsupplied — **request them from the user**. A brief without TA or channel is useless.
+
+## Protocol
+
+### Step 1 — Goal and Context
+1. Record the **content goal** — what the reader must do after consuming it (subscribe, buy, click, remember the brand).
+2. Define the **funnel stage**: TOFU (awareness) / MOFU (consideration) / BOFU (decision).
+3. Indicate the **publication context** — why specifically now (trend, season, launch, current event).
+
+### Step 2 — Audience and Tone
+1. Assign a specific **persona** from `$audience-analysis`.
+2. Document the **tone** for this persona (from `$tone-of-voice` / `$brand-guidelines`).
+3. Specify the **customer language** — words and phrases that resonate with this persona.
+
+### Step 3 — Content Core
+1. Formulate an **exact topic** (not generic, but a specific angle).
+2. Outline **key theses** (3-5 mandatory points).
+3. Specify **forbidden topics** and phrasing.
+4. List **mandatory elements** — facts, quotes, data, statistics.
+
+### Step 4 — SEO (for text formats)
+> Skip for non-SEO formats (stories, reels, email).
+
+1. **Primary keyword** + 3-5 secondary ones.
+2. **Search intent** — informational / navigational / transactional.
+3. **SERP competitors** — top-3 search results (to gauge required quality).
+4. **Meta-title and meta-description** — if applicable.
+
+### Step 5 — Format and Structure
+1. State the **format** (post, carousel, article, reel, email, thread, etc.).
+2. Set the **volume/length** — characters / words / slides / seconds.
+3. Describe the **structure** — sequence of sections, headings, hook.
+4. Call out **platform constraints** — character limits, aspect ratios, duration.
+
+### Step 6 — CTA
+1. **Primary CTA** — one specific action (not "subscribe and buy and share").
+2. **Secondary CTA** — if applicable (save, send to a friend).
+3. CTA must align with the funnel stage from Step 1.
+
+### Step 7 — Visual Requirements
+1. Describe the **visual concept** — what is in the image/video.
+2. Dictate the **style** — from `$brand-guidelines` (photo / illustration / typography / mix).
+3. Give **dimensions** — appropriate to the platform.
+4. If a full visual brief is required → link to `$visual-brief`.
+
+### Step 8 — References
+1. **Own best** — 1-2 examples of own content that worked.
+2. **Competitor** — 1-2 examples from `$competitor-content-analysis`.
+3. **Inspiration** — from other niches / platforms (if applicable).
+4. For each reference — specifically note what to borrow (structure, tone, hook, visual).
+
+### Step 9 — Distribution
+1. **Primary channel** — where we publish.
+2. **Cross-posting** — adaptations for other platforms (specify what must be altered).
+3. **Promo** — organic / paid / both. Budget, if known.
+4. **Partnerships** — collaborations, influencers, reposts (if planned).
+
+### Step 10 — Metrics and Deadline
+1. **Success metrics** — 2-3 specific KPIs with target values (ER > 5%, reach > 10K, clicks > 200).
+2. **Production deadline** — when the content must be finished.
+3. **Publication date** — when it goes live.
+
+## Validation (Quality Gate)
+
+A brief is deemed ready for handoff if:
+
+- [ ] Goal is specific and measurable (not "gain attention", but "webinar subscriptions")
+- [ ] A specific persona is listed (not "everyone")
+- [ ] Platform and format are determined
+- [ ] Key theses are specific (3-5 items)
+- [ ] CTA is a single primary action, matching the funnel stage
+- [ ] Volume and structure are laid out
+- [ ] Visual requirements are specified (at least minimal)
+- [ ] Metrics carry target values
+- [ ] SEO-block is populated (for text formats) or marked N/A
+- [ ] No conflicts (a TOFU goal + "buy now" CTA = conflict)
+
+## Handoff
+
+| Outcome | Routing |
+|------|---------|
+| Brief is ready, text is needed | → **Copywriter** (or Researcher → Copywriter if the topic mandates research) |
+| Brief is ready, visuals are needed | → **Visual Concept** (with `$visual-brief` or the visual excerpt from this brief) |
+| Brief is ready, text + visuals | → **Copywriter** + **Visual Concept** in parallel |
+
+When handing off — use `$handoff` attaching the full brief and declaring its status.
+
+## Integration with other skills
+
+| Skill | Interaction |
+|------|----------------|
+| `$content-calendar` | Source: topic, date, content unit ID |
+| `$audience-analysis` | Source: persona, pain points, triggers, customer language |
+| `$platform-strategy` | Source: platform, format, publication time |
+| `$brand-guidelines` | Source: ToV, visual standards |
+| `$tone-of-voice` | Source: detailed tone for the persona |
+| `$competitor-content-analysis` | Source: references, gaps |
+| `$visual-brief` | Consumer: detailed visual spec is drafted from the brief |
+| `$seo-copywriting` | Consumer: implements the SEO-block from the brief |
+| `$brand-compliance` | Verifies final content against data inside the brief |
+
+## Anti-patterns
+
+| Error | Why it's bad | How to do it right |
+|--------|-------------|---------------|
+| "Topic: marketing" | Too broad — the copywriter lacks an angle | Specific angle: "5 email-marketing mistakes for SaaS in 2026" |
+| No persona | Text to nobody = text for nobody | Always a specific persona from `$audience-analysis` |
+| 3 CTAs in one post | Attention scatter, conversion drops | One primary CTA |
+| TOFU Goal + "buy" CTA | Conflict between funnel stage and action | CTA matches the stage: TOFU = subscribe/learn |
+| Brief without deadline | Task without timeframe = without priority | Always feature production deadline + publication date |
+| Lacking references | Copywriter guesses the baseline | 2-3 references explicitly stating "what to take" |
+| Non-specified volume | Results in 200 words or 2,000 | Provide a definite range: "800-1000 words" |
+
+## Brief Statuses
+
+| Status | Meaning |
+|--------|----------|
+| `Draft` | Brief is in progress, not all fields are filled |
+| `Ready` | Brief passed validation, ready for handoff |
+| `In Production` | Content is being fashioned based on the brief |
+| `Review` | Content bounced back for verification |
+| `Done` | Content published |
+
+## Output Template
+
+```
+### Content Brief — [Topic]
+
+**ID:** [unique ID from content calendar]
+**Status:** [Draft / Ready / In Production / Review / Done]
+**Version:** [N]
+**Publication Date:** [date]
+**Production Deadline:** [date]
+
+---
+
+#### 1. Goal and Context
+- **Goal:** [what the reader should do]
+- **Funnel stage:** [TOFU / MOFU / BOFU]
+- **Context:** [why now — trend, season, launch]
+
+#### 2. Audience
+- **Persona:** [name from $audience-analysis]
+- **Pain points:** [key persona pain points relevant to the topic]
+- **Triggers:** [motivators for action]
+- **Customer language:** [words and phrases]
+
+#### 3. Content Core
+- **Topic:** [exact topic / specific angle]
+- **Key theses:**
+  1. [thesis 1]
+  2. [thesis 2]
+  3. [thesis 3]
+- **Forbidden topics:** [list]
+- **Mandatory elements:** [facts, quotes, data, statistics]
+
+#### 4. SEO (if applicable)
+- **Primary keyword:** [keyword]
+- **Secondary:** [list]
+- **Search intent:** [informational / navigational / transactional]
+- **SERP competitors:** [top-3 URLs + pros/cons]
+- **Meta:** Title: [≤60 characters] · Description: [≤160 characters]
+> N/A — if format lacks an SEO component.
+
+#### 5. Format and Structure
+- **Platform:** [platform]
+- **Format:** [post / carousel / article / reel / email / thread]
+- **Volume:** [characters / words / slides / seconds]
+- **Structure:**
+  1. Hook — [description]
+  2. Main body — [description]
+  3. Close — [description]
+- **Platform constraints:** [limits]
+
+#### 6. Style
+- **ToV:** [tone from $brand-guidelines / $tone-of-voice]
+- **Visual style:** [from $brand-guidelines]
+- **Visual dimensions:** [WxH px]
+- **Visual concept:** [what's pictured/videoed]
+> Full visual brief → `$visual-brief` (if needed)
+
+#### 7. CTA
+- **Primary CTA:** [one specific action]
+- **Secondary CTA:** [if there is one]
+- **Funnel alignment:** [TOFU→subscribe / MOFU→download / BOFU→buy]
+
+#### 8. References
+| # | Source | Link | What to borrow |
+|---|----------|--------|-----------|
+| 1 | [own / competitor / inspiration] | [link] | [structure / hook / tone / visual] |
+| 2 | [own / competitor / inspiration] | [link] | [what to borrow] |
+
+#### 9. Distribution
+- **Primary channel:** [platform]
+- **Cross-posting:** [platforms + what to adapt]
+- **Promo:** [organic / paid / budget]
+- **Partnerships:** [collaborations, if any]
+
+#### 10. Success Metrics
+| Metric | Target |
+|---------|-----------------|
+| [ER / reach / clicks / conversions] | [number or %] |
+| [metric 2] | [number or %] |
+
+**→ Hand over to:** [Copywriter / Researcher / Visual Concept]
+```