arkaos 4.7.0 → 4.8.0

package/departments/landing/skills/affiliate-bridge/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/affiliate-bridge
 description: >
-  Affiliate bridge page: pre-sell, review, comparison before sending to offer.
+  Affiliate bridge page spec that pre-sells a third-party offer: review or
+  comparison angle, page copy, trust elements, and affiliate tracking setup
+  before sending traffic to the vendor. TRIGGER: "bridge page", "página de
+  afiliado", "pré-venda de afiliado", "affiliate pre-sell", "review page
+  para oferta de afiliado", "/landing affiliate". SKIP: designing a
+  multi-step funnel around your OWN product -> landing/funnel-design
+  (bridge pages only front someone else's offer).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/awareness-diagnose/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: landing/awareness-diagnose
 description: >
-  Diagnose audience awareness level: unaware, problem, solution, product, most aware.
+  Diagnose where the audience sits on Schwartz's 5 awareness levels
+  (unaware, problem, solution, product, most aware) plus traffic
+  temperature, and recommend the matching copy framework. TRIGGER:
+  "awareness level", "nível de consciência do público", "o público conhece
+  o produto?", "traffic temperature", "que framework de copy usar",
+  "/landing awareness". SKIP: actually writing the copy once the level is
+  known -> landing/copy-framework (it applies the framework; this skill
+  only diagnoses).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/copy-framework/SKILL.md

@@ -1,8 +1,13 @@
 ---
 name: landing/copy-framework
 description: >
-  Select and apply the right copywriting framework based on audience awareness level.
-  8 frameworks: AIDA, PAS, PASTOR, PPPP, BAB, StoryBrand, Star-Story-Solution, 4 U's.
+  Select and apply the right copywriting framework for a landing page by
+  awareness level — 8 frameworks (AIDA, PAS, PASTOR, PPPP, BAB, StoryBrand,
+  Star-Story-Solution, 4 U's) — producing headline variants, body copy and
+  CTA. TRIGGER: "escreve o copy da landing", "sales copy", "aplica AIDA",
+  "copy PAS", "texto persuasivo para a página", "/landing copy". SKIP:
+  headlines only -> landing/headline-write; blog, social or editorial
+  content -> /content (this skill is conversion copy for pages).
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/landing/skills/email-sequence/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/email-sequence
 description: >
-  Email sequence: cart abandonment, nurture, launch, post-purchase.
+  Standalone email sequence design — cart abandonment, nurture, launch,
+  post-purchase — with subject lines, body copy, timing, and segmentation
+  (PLF + Schwartz). TRIGGER: "email sequence", "sequência de emails",
+  "emails de carrinho abandonado", "nurture emails", "emails pós-compra",
+  "/landing email". SKIP: full PLF product launch with PLC content and cart
+  timeline -> landing/launch-sequence; webinar reminder and replay emails
+  -> landing/webinar-funnel (both own their sequences end-to-end).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/funnel-design/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: landing/funnel-design
 description: >
-  Sales funnel architecture using Brunson's Value Ladder. Selects funnel type
-  based on product, audience awareness, and price point.
+  Sales funnel architecture on Brunson's Value Ladder: selects the funnel
+  type (squeeze, tripwire, SLO, webinar, application) by product, audience
+  awareness and price point, then defines every step from traffic source
+  through upsell and thank-you page. TRIGGER: "sales funnel", "desenha o
+  funil", "funil de vendas", "value ladder", "que funil usar para este
+  produto", "/landing funnel". SKIP: webinar-specific funnel with pitch
+  script and sequences -> landing/webinar-funnel; single-page structure
+  only -> landing/page-architect.
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/landing/skills/funnel-metrics/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/funnel-metrics
 description: >
-  Funnel metrics: conversion per stage, drop-off diagnosis, attribution.
+  Funnel metrics report: stage-by-stage conversion rates, drop-off
+  diagnosis, attribution, and a prioritised optimization plan. TRIGGER:
+  "funnel metrics", "métricas do funil", "onde estamos a perder
+  conversões", "conversion drop-off", "análise de conversão por etapa",
+  "/landing metrics". SKIP: fixing one specific page rather than the whole
+  funnel -> landing/optimize-page (page-level CRO); designing an experiment
+  on a single element -> landing/ab-test.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/headline-write/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/headline-write
 description: >
-  Write 10+ headline variants matched to audience awareness level.
+  Write 10+ headline variants matched to the audience's awareness level
+  (Ogilvy rules + Schwartz), with per-variant rationale and an A/B test
+  plan. TRIGGER: "headline", "escreve títulos", "título da landing page",
+  "hero headline", "10 headlines para o produto", "/landing headline".
+  SKIP: full-page copy beyond the headline -> landing/copy-framework
+  (headlines are one output of it); video or social hooks ->
+  content/hook-write; running the actual headline test -> landing/ab-test.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/landing-gen/SKILL.md

@@ -1,9 +1,15 @@
 ---
 name: landing/landing-gen
 description: >
-  Generate high-converting landing pages as complete TSX components.
-  Hero, features, pricing, FAQ, testimonials, CTA sections with
-  proven copy frameworks (PAS, AIDA, BAB) and SEO optimization.
+  Generate a complete, production-ready landing page as TSX + Tailwind
+  components — hero, features, pricing, FAQ, testimonials, CTA, footer —
+  with copy framework (PAS/AIDA/BAB), design style, SEO checklist and Core
+  Web Vitals targets. TRIGGER: "cria uma landing page", "build a landing
+  page", "gera a página do produto", "landing em Next.js", "página de
+  vendas em código", "/landing gen". SKIP: wireframe or section structure
+  without code -> landing/page-architect; e-commerce product and store
+  pages -> /ecom (store pages live in the shop platform, not standalone
+  landings).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
 ---
 

package/departments/landing/skills/launch-sequence/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/launch-sequence
 description: >
-  Product launch using PLF: PLC 1-3, open cart, closing sequence.
+  Product launch plan using Jeff Walker's Product Launch Formula:
+  pre-launch content PLC 1-3, open cart, closing sequence, with email
+  sequences and cart timeline. TRIGGER: "product launch", "plano de
+  lançamento", "lançamento do produto", "PLF", "sequência de lançamento",
+  "open cart", "/landing launch". SKIP: a standalone email sequence outside
+  a launch window -> landing/email-sequence; webinar-driven launch ->
+  landing/webinar-funnel (there the webinar IS the launch event).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/offer-create/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: landing/offer-create
 description: >
-  Create irresistible offers using Hormozi's Grand Slam Offer formula and Value Equation.
-  Outputs: offer breakdown, bonus stack, guarantee, pricing, objection handling.
+  Create an irresistible offer with Hormozi's Grand Slam Offer formula and
+  Value Equation: dream outcome, problem list, solution bundle, bonus
+  stack, guarantee type, value-anchored pricing, and real scarcity.
+  TRIGGER: "cria a oferta", "grand slam offer", "oferta irresistível",
+  "bonus stack", "structure my offer", "garantia e preço da oferta",
+  "/landing offer". SKIP: a client-specific sales proposal document ->
+  sales/proposal-write (proposals sell to ONE prospect; offers are
+  productised); page copy presenting the offer -> landing/copy-framework.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/optimize-page/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: landing/optimize-page
 description: >
-  Landing page CRO: heuristic analysis, heatmap review, test prioritization.
+  Landing page CRO with ResearchXL: heuristic analysis, heatmap review, and
+  a prioritized test backlog for an existing page. TRIGGER: "otimiza a
+  página", "optimize the landing page", "a página não converte", "CRO",
+  "conversion audit", "/landing optimize". SKIP: planning one specific
+  experiment -> landing/ab-test (this skill decides WHAT to test, that one
+  designs the test); funnel-wide drop-off diagnosis ->
+  landing/funnel-metrics; building a new page from scratch ->
+  landing/landing-gen.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/page-architect/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: landing/page-architect
 description: >
-  Landing page structure: above fold, sections, CTAs, attention ratio 1:1.
+  Landing page structural wireframe: above-the-fold anatomy, section order,
+  copy blocks, CTA placement, and 1:1 attention ratio — blueprint, not code
+  or final copy. TRIGGER: "estrutura da landing page", "page structure",
+  "wireframe da página", "que secções deve ter a página", "above the fold",
+  "/landing page". SKIP: production TSX implementation ->
+  landing/landing-gen (it builds; this skill blueprints); writing the
+  actual section copy -> landing/copy-framework.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/persuasion-apply/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: landing/persuasion-apply
 description: >
-  Persuasion elements audit: reciprocity, scarcity, authority, consistency, liking, consensus.
+  Persuasion audit of a page or funnel against Cialdini's 6 principles —
+  reciprocity, scarcity, authority, consistency, liking, consensus — with
+  element-by-element assessment and concrete improvements. TRIGGER:
+  "persuasão", "aplica Cialdini", "prova social", "social proof audit",
+  "make the page more persuasive", "gatilhos mentais", "/landing persuade".
+  SKIP: building scarcity or guarantees into the offer itself ->
+  landing/offer-create; data-driven test prioritisation ->
+  landing/optimize-page (this audit is principle-based, not
+  analytics-based).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/landing/skills/webinar-funnel/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: landing/webinar-funnel
 description: >
-  Webinar funnel design — registration page, reminder sequence, live pitch
-  script structure, replay/cart sequence, conversion targets.
+  Full webinar funnel (Brunson Perfect Webinar + false-belief patterns):
+  registration page, 5-email reminder sequence, timed live pitch script
+  with offer stack, replay/cart sequence, conversion targets and tracking
+  spec. TRIGGER: "webinar funnel", "funil de webinar", "cria um webinar",
+  "webinar pitch script", "perfect webinar", "/landing webinar". SKIP:
+  choosing among funnel types when webinar is not yet decided ->
+  landing/funnel-design (it selects the funnel; this executes the webinar
+  path); non-webinar launch emails -> landing/launch-sequence.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/change-manage/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/change-manage
 description: >
-  Change management plan: stakeholder analysis, communication, resistance handling.
+  Change management plan for an organisational initiative: stakeholder analysis,
+  communication cadence, resistance handling, timeline and risk mitigations.
+  TRIGGER: "plano de gestão da mudança", "vamos reorganizar a equipa", "change
+  management", "como comunico esta mudança", "handle resistance to change",
+  "/lead change <initiative>". SKIP: designing the new team structure itself ->
+  org/org-design (structure first, change plan second); interpersonal friction
+  between two people -> lead/conflict-resolve (person-level, not
+  initiative-level).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/conflict-resolve/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/conflict-resolve
 description: >
-  Conflict resolution: understand both DISC profiles, find resolution path.
+  Conflict resolution between people: reads both parties' DISC profiles and
+  produces a resolution path with a communication strategy for each side.
+  TRIGGER: "conflito na equipa", "estes dois não se entendem", "resolve
+  conflict", "mediar uma discussão", "team members clashing",
+  "/lead conflict <situation>". SKIP: profiling one person's behavioural style
+  without an active conflict -> lead/disc-assess (assessment, not mediation);
+  systemic team-wide friction -> lead/team-health (diagnoses the five
+  dysfunctions, not a single dispute).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/culture-audit/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: lead/culture-audit
 description: >
-  Culture audit: assess values lived vs stated, team health, feedback loops.
+  Culture audit: assesses values lived vs stated, team health and feedback
+  loops, producing a report with health scores, gaps and improvement actions.
+  TRIGGER: "auditoria à cultura", "a cultura está a degradar-se", "culture
+  audit", "vivemos os nossos valores?", "values vs reality", "/lead culture".
+  SKIP: defining values and culture from scratch -> org/culture-define (creates
+  the culture; this skill audits an existing one); trust/conflict diagnosis of
+  one team -> lead/team-health (Lencioni pyramid, not company-wide culture).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/delegation-matrix/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/delegation-matrix
 description: >
-  Delegation analysis: what to delegate, to whom, with what authority level.
+  Delegation analysis: decides what to delegate, to whom, and with which
+  authority level, producing a delegation matrix with check-in cadence per
+  task. TRIGGER: "o que devo delegar", "estou sobrecarregado, delega isto",
+  "delegation matrix", "níveis de autoridade", "who should own this task",
+  "/lead delegate <task>". SKIP: deciding how decisions get made across the
+  org -> org/decision-framework (decision rights, not task handoff); hiring
+  someone new to absorb the work -> lead/hiring-plan (role creation, not
+  delegation of existing work).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/disc-assess/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/disc-assess
 description: >
-  DISC assessment: identify behavioral style, adapt communication accordingly.
+  DISC behavioural assessment of a person or team: identifies the style and
+  produces a profile with communication recommendations and conflict-resolution
+  tips. TRIGGER: "perfil DISC", "avalia o estilo comportamental", "DISC
+  assessment", "como comunico com ele", "adapt my communication style",
+  "/lead disc <person/team>". SKIP: an active dispute between two people ->
+  lead/conflict-resolve (mediation that uses DISC, not the assessment itself);
+  whole-team dysfunction signals -> lead/team-health (Lencioni model beats
+  individual profiling).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/feedback-give/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/feedback-give
 description: >
-  Structured feedback: care personally + challenge directly. Specific, immediate, behavioral.
+  Structured feedback with Radical Candor (care personally + challenge
+  directly): specific, immediate, behavioural — situation, behaviour, impact
+  and follow-up actions. TRIGGER: "dá feedback à equipa", "como digo isto ao
+  colaborador", "give feedback", "feedback difícil", "radical candor",
+  "/lead feedback <person>". SKIP: formal cycle evaluation with evidence and a
+  development plan -> lead/performance-review (periodic review, not
+  in-the-moment feedback); adapting to the person's behavioural style before
+  the conversation -> lead/disc-assess.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/hiring-plan/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/hiring-plan
 description: >
-  Hiring plan: scorecard, sourcing strategy, structured interview guide, sell plan.
+  Hiring plan with the Who Method (Geoff Smart): role scorecard, sourcing
+  strategy, structured interview guide, evaluation rubric and sell plan.
+  TRIGGER: "hiring plan", "vamos contratar um developer", "plano de
+  contratação", "scorecard para a vaga", "structured interview questions",
+  "/lead hiring <role>". SKIP: designing salary bands and career ladders ->
+  org/compensation-plan (pay structure, not the hire); ramping the person
+  after signing -> org/onboarding-design (post-offer onboarding, not
+  selection).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/okr-define/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: lead/okr-define
 description: >
-  Define OKRs using John Doerr's framework. Cascading from company to team level.
-  Objectives are qualitative, Key Results are quantitative.
+  Defines OKRs with John Doerr's framework, cascading company -> team:
+  qualitative Objectives, quantitative Key Results, scoring criteria and
+  check-in schedule. TRIGGER: "define OKRs", "objetivos do trimestre", "OKRs
+  da equipa", "key results", "quarterly goals", "/lead okr <scope>". SKIP:
+  running the quarterly/weekly ritual on OKRs that already exist ->
+  org/okr-cadence (operates the cadence; this skill writes the OKRs);
+  individual performance goals -> lead/performance-review (person-level, not
+  team objectives).
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/leadership/skills/performance-review/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: lead/performance-review
 description: >
-  Performance review preparation: evidence gathering, feedback structure, development plan.
+  Performance review preparation: gathers evidence, structures feedback points
+  and builds a development plan for the review conversation. TRIGGER:
+  "avaliação de desempenho", "performance review", "prepara a review do
+  colaborador", "plano de desenvolvimento", "review cycle prep",
+  "/lead review <person>". SKIP: quick in-the-moment feedback outside a formal
+  cycle -> lead/feedback-give (Radical Candor beats a full review for
+  immediacy); salary or promotion banding decisions -> org/compensation-plan
+  (pay structure lives in org).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/leadership/skills/team-health/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: lead/team-health
 description: >
-  Team health assessment using Lencioni's Five Dysfunctions model.
-  Diagnoses trust, conflict, commitment, accountability, and results focus.
+  Team health assessment with Lencioni's Five Dysfunctions: diagnoses trust,
+  conflict, commitment, accountability and results focus into a scorecard with
+  fix-order actions. TRIGGER: "team health", "a equipa está disfuncional",
+  "saúde da equipa", "falta de confiança na equipa", "five dysfunctions",
+  "/lead team-build <context>". SKIP: broader capability and staffing
+  assessment -> org/team-assess (competencies, not dysfunction diagnosis); a
+  dispute between two individuals -> lead/conflict-resolve (person-level
+  mediation).
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/marketing/skills/ab-test/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: mkt/ab-test
 description: >
-  A/B test plan: hypothesis, variants, sample size, duration, success criteria.
+  A/B test plan: hypothesis, variants, sample size, duration, and success
+  criteria, prioritised with ICE scoring and statistical significance.
+  TRIGGER: "A/B test", "teste A/B", "testa duas variantes", "split test",
+  "qual variante ganha", "/mkt ab-test <element>". SKIP: testing
+  landing-page copy or layout inside a funnel -> landing/ab-test (owns
+  on-page conversion experiments); redesigning the page itself ->
+  landing/optimize-page.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/analytics-report/SKILL.md

@@ -1,7 +1,16 @@
 ---
 name: mkt/analytics-report
 description: >
-  Marketing analytics report: AARRR funnel, channel performance, CAC trends.
+  Marketing analytics report: AARRR pirate-metrics funnel, channel
+  performance breakdown, and CAC trends for a given period. TRIGGER:
+  "relatório de marketing", "analytics report", "como estão as métricas
+  de marketing", "AARRR", "CAC por canal", "/mkt analytics <period>".
+  SKIP: designing or instrumenting the AARRR growth loop itself (not
+  reporting on it) -> mkt/growth-loop (builds the loop; this skill reports
+  the metrics); store or e-commerce sales analytics -> ecom/analytics (owns
+  revenue and product metrics); content platform performance ->
+  content/analytics; funnel step conversion diagnosis ->
+  landing/funnel-metrics.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/audience-segment/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: mkt/audience-segment
 description: >
-  Audience segmentation: demographics, psychographics, behavior, value segments.
+  Audience segmentation into demographic, psychographic, behavioural, and
+  value segments, with targeting recommendations per channel. TRIGGER:
+  "segmenta a audiência", "audience segmentation", "quem é o meu
+  público", "define os segmentos", "target segments", "/mkt segment
+  <criteria>". SKIP: RFM segmentation of an existing customer base by
+  purchase history -> ecom/rfm-segment (recency/frequency/monetary
+  maths); mapping how segments move through touchpoints ->
+  ecom/customer-journey.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/calendar-plan/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: mkt/calendar-plan
 description: >
-  Content calendar: themes, formats, platforms, publishing schedule per week.
+  Weekly marketing content calendar: themes, formats, platforms, and
+  publishing schedule with assigned topics and deadlines. TRIGGER:
+  "calendário de conteúdos", "content calendar", "plano de publicações",
+  "posting schedule", "o que publicar esta semana", "/mkt calendar
+  <period>". SKIP: creator-economy editorial calendar tied to a channel
+  content system -> content/calendar (owns the content department's
+  publishing pipeline); the social strategy behind the calendar ->
+  mkt/social-strategy.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/cold-email/SKILL.md

@@ -1,9 +1,14 @@
 ---
 name: mkt/cold-email
 description: >
-  Write and iterate B2B cold email sequences that get replies.
-  First-touch emails, multi-email sequences, and performance iteration.
-  Uses AIDA framework and peer-level voice calibration.
+  Writes and iterates B2B cold email: single first-touch emails, 5-6
+  email sequences with cadence, and performance-driven revisions, using
+  AIDA, peer-level voice calibration, and deliverability checks. TRIGGER:
+  "cold email", "email frio", "escreve um cold email", "sequência de
+  outreach", "prospecção por email", "/mkt cold-email <mode>". SKIP:
+  lifecycle emails to existing subscribers (welcome, nurture, win-back)
+  -> mkt/email-sequence (owned audiences, not cold prospects); the sales
+  proposal after a reply -> sales/proposal-write.
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/marketing/skills/competitor-analysis/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: mkt/competitor-analysis
 description: >
-  Marketing competitor analysis: SEO, paid, social, content, email, positioning gaps.
+  Marketing competitor analysis across SEO, paid, social, content, email,
+  and positioning gaps, delivered as a report with opportunities and a
+  battlecard. TRIGGER: "analisa o concorrente", "competitor analysis", "o
+  que anda a fazer a concorrência", "competitive gaps", "battlecard",
+  "/mkt competitor <name>". SKIP: industry structure and strategic forces
+  -> strat/five-forces (market strategy, not channel tactics); live
+  browsing of a competitor's store -> ecom/browse-competitor;
+  defensibility and moats -> strat/moat-analysis.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/content-audit/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: mkt/content-audit
 description: >
-  Audit existing content: performance, gaps, refresh opportunities, pruning candidates.
+  Audit of the existing content inventory: performance, gaps, refresh
+  opportunities, and pruning candidates, with action items per piece.
+  TRIGGER: "auditoria de conteúdo", "content audit", "que conteúdo devo
+  atualizar", "prune old posts", "refresh content", "/mkt content audit".
+  SKIP: full-site technical and on-page SEO review -> mkt/seo-audit (owns
+  CWV, meta, link profile); planning the future calendar from the
+  findings -> mkt/calendar-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/email-sequence/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: mkt/email-sequence
 description: >
-  Email sequence design: welcome, nurture, launch, cart abandonment, win-back.
+  Email sequence design for owned audiences: welcome, nurture, launch,
+  cart abandonment, and win-back flows with subject lines, body copy,
+  timing, and segmentation (Schwartz 5 awareness levels). TRIGGER:
+  "sequência de emails", "email sequence", "fluxo de boas-vindas",
+  "nurture flow", "emails de win-back", "/mkt email sequence <type>".
+  SKIP: cold outreach to strangers -> mkt/cold-email (prospecting, not
+  owned lists); launch-funnel emails tied to a sales page ->
+  landing/email-sequence; recurring editorial newsletter ->
+  content/newsletter-write.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/marketing-automation/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: mkt/marketing-automation
 description: >
-  Marketing automation: trigger-based workflows for lead nurturing and scoring.
+  Marketing automation design: trigger-based workflows for lead nurturing
+  and lead scoring, delivered as a flow diagram with triggers, actions,
+  and conditions. TRIGGER: "automatiza o marketing", "marketing
+  automation", "lead scoring", "workflow de nurturing", "automated drip",
+  "/mkt automate <workflow>". SKIP: generic business-process automation
+  or platform selection -> ops/workflow-automate (picks Zapier vs Make vs
+  n8n); writing the emails inside the flow -> mkt/email-sequence.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/paid-campaign/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: mkt/paid-campaign
 description: >
-  Paid campaign setup: platform selection, targeting, budget, creative brief, ROAS targets.
+  Paid campaign setup: platform selection, targeting, budget allocation,
+  creative brief, and ROAS targets, prioritised with ICE scoring.
+  TRIGGER: "campanha paga", "lança uma campanha de ads", "paid campaign",
+  "Google Ads", "Meta Ads", "quanto investir em ads", "/mkt paid
+  <platform> <goal>". SKIP: deciding which ad variant wins ->
+  mkt/ab-test (experiment design, not campaign setup); organic social
+  plan -> mkt/social-strategy; the landing page the ads point to ->
+  landing/landing-gen.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/programmatic-seo/SKILL.md

@@ -1,9 +1,14 @@
 ---
 name: mkt/programmatic-seo
 description: >
-  Build SEO-optimized pages at scale using templates and data.
-  12 playbooks: Templates, Curation, Conversions, Comparisons, Examples,
-  Locations, Personas, Integrations, Glossary, Translations, Directory, Profiles.
+  Builds SEO-optimized pages at scale from templates plus data, using 12
+  playbooks (templates, comparisons, locations, personas, integrations,
+  glossary, directories, more) with demand validation, data-defensibility
+  tiers, and indexation strategy. TRIGGER: "programmatic SEO", "pSEO",
+  "páginas SEO em escala", "gera páginas por template", "uma página por
+  cidade/keyword", "/mkt programmatic-seo <niche>". SKIP: auditing an
+  existing site's SEO health -> mkt/seo-audit (diagnosis, not page
+  generation); hand-written editorial content plan -> mkt/calendar-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/marketing/skills/seo-audit/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: mkt/seo-audit
 description: >
-  Full SEO audit covering technical SEO, on-page, content gaps, and link profile.
-  Uses Pillar-Cluster model, E-E-A-T, and Core Web Vitals.
+  Full SEO audit: technical SEO (Core Web Vitals, sitemap, canonicals),
+  on-page, pillar-cluster content gaps, E-E-A-T signals, and link
+  profile. TRIGGER: "SEO audit", "auditoria SEO", "porque não estou a
+  rankear", "revê o SEO do site", "Core Web Vitals", "/mkt seo audit
+  <url>". SKIP: generating new SEO pages at scale -> mkt/programmatic-seo
+  (builds, this audits); content performance and pruning ->
+  mkt/content-audit; competitor SEO comparison ->
+  mkt/competitor-analysis.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---