arkaos 4.7.1 → 4.8.0

package/departments/brand/skills/design-system/SKILL.md

@@ -1,8 +1,15 @@
 ---
 name: brand/design-system
 description: >
-  Production design system specification: tokens, atoms, molecules, organisms,
-  templates, and pages — with WCAG AA conformance and Storybook export contract.
+  Ships a production design system in 5 deliverables: design-tokens.json
+  (primitive + semantic layers), an Atomic Design component catalog (atoms to
+  pages), WCAG 2.2 AA conformance report, Storybook CSF3 story stubs, and an
+  integration guide. TRIGGER: "design system", "cria o design system", "design
+  tokens", "component library", "biblioteca de componentes", "/brand
+  design-system". SKIP: only a color palette -> brand/colors; implementing the
+  components in application code -> dev frontend workflows (this skill
+  specifies the system, it does not build the app); reviewing an existing UI
+  against brand guidelines -> brand/design-review.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/identity-system/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/identity-system
 description: >
-  Full brand identity: strategy, verbal, visual in the correct order (never skip to visuals).
+  Builds a full brand identity in the correct order — strategy, then verbal,
+  then visual (never skips to visuals) — via the Wheeler process and Primal
+  Branding, verifying live brand elements through browser and Computer Use
+  steps. TRIGGER: "cria a identidade da marca", "brand identity", "identidade
+  visual completa", "rebranding completo", "build the brand from scratch",
+  "/brand identity <name>". SKIP: only a logo -> brand/logo-brief; only
+  positioning -> brand/positioning-statement; measuring an EXISTING brand's
+  strength -> brand/primal-audit (audit, not creation).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/logo-brief/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/logo
 description: >
-  Logo concept generation: brief, mood references, AI-generated concepts.
+  Generates logo concepts from a brief: mood references, AI-generated concept
+  directions, variations, rationale, and usage guidelines. TRIGGER: "logo
+  brief", "cria um logo", "desenha o logótipo", "logo concepts", "preciso de
+  um logo", "/brand logo <brief>". SKIP: logo as part of a whole identity
+  (strategy + verbal + visual) -> brand/identity-system (order matters, the
+  logo comes last); applying an existing logo to product, packaging, or social
+  scenes -> brand/mockup-generate.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/mockup-generate/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/mockup
 description: >
-  Generate mockups: product, packaging, social, stationery with brand identity applied.
+  Generates brand-applied mockups — product, packaging, social, and stationery
+  — with AI image-generation prompts and brand application guidelines.
+  TRIGGER: "cria mockups", "mockup do produto", "packaging mockup", "aplica a
+  marca no produto", "social media mockup", "/brand mockup <type>". SKIP:
+  low-fidelity screen structure and layout -> brand/wireframe (structure
+  before pixels); creating the logo itself -> brand/logo-brief (concepts, not
+  application).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/naming-evaluate/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/naming-evaluate
 description: >
-  Generate and evaluate brand names using Alexandra Watkins' SMILE & SCRATCH framework.
+  Generates 30+ brand name candidates across six categories and evaluates them
+  with Alexandra Watkins' SMILE & SCRATCH framework, plus domain and social
+  handle checks, down to a 5-name shortlist. TRIGGER: "nome para a marca",
+  "sugere nomes", "brand naming", "avalia este nome", "is this a good name",
+  "/brand naming <project>". SKIP: the name exists and needs a market position
+  -> brand/positioning-statement; defining the personality behind the name ->
+  brand/archetype-finder.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/positioning-statement/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/positioning-statement
 description: >
-  Brand positioning: FOR [target] WHO [need] [brand] IS A [category] THAT [benefit].
+  Writes a brand positioning statement in the Ries/Trout format — FOR [target]
+  WHO [need], [brand] IS A [category] THAT [benefit] — with competitive
+  context and validation criteria. TRIGGER: "posicionamento da marca",
+  "positioning statement", "como nos posicionamos", "define o posicionamento",
+  "what makes us different", "/brand positioning <name>". SKIP: market-level
+  strategic positioning and competitive moves -> strategy/position (business
+  strategy, not the brand message); brand still unnamed ->
+  brand/naming-evaluate first.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/primal-audit/SKILL.md

@@ -1,8 +1,13 @@
 ---
 name: brand/primal-audit
 description: >
-  Audit an existing brand against Patrick Hanlon's 7 Primal Code elements.
-  Identifies missing elements and provides recommendations to strengthen the brand.
+  Audits an existing brand against Patrick Hanlon's 7 Primal Code elements
+  using a 21-point evidence-cited rubric, a competitor benchmark, and a ranked
+  remediation plan. TRIGGER: "audita a marca", "brand audit", "primal audit",
+  "quão forte é a nossa marca", "how strong is our brand", "/brand audit".
+  SKIP: auditing the interface, not the brand -> brand/ux-audit (Nielsen
+  heuristics on usability); no brand exists yet to audit ->
+  brand/identity-system (creation, not audit).
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/ux-audit/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/ux-audit
 description: >
-  UX heuristic audit: evaluate interface against Nielsen's 10 heuristics.
+  UX heuristic audit of a live interface against Nielsen's 10 heuristics and
+  Laws of UX — navigates real user flows in the browser, checks accessibility
+  and responsive breakpoints, and delivers severity-rated findings with fixes.
+  TRIGGER: "ux audit", "audita a usabilidade", "auditoria de UX", "heuristic
+  evaluation", "porque é que os users se perdem", "/brand ux-audit <url>".
+  SKIP: on-brand visual compliance (palette, typography vs brandbook) ->
+  brand/design-review; slow pages or Core Web Vitals -> dev/performance-audit;
+  brand strength, not interface -> brand/primal-audit.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/voice-guide/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/voice-guide
 description: >
-  Brand voice and tone guide: personality, vocabulary, do's/don'ts, examples per channel.
+  Creates a brand voice and tone guide — personality, vocabulary, do's and
+  don'ts, tone matrix, and channel-specific examples — using StoryBrand and
+  the Primal sacred lexicon. TRIGGER: "brand voice", "tom de voz da marca",
+  "voice guide", "define o tom de comunicação", "como é que a marca fala",
+  "/brand voice <context>". SKIP: writing actual copy with that voice ->
+  landing/copy-framework or content/hook-write (they produce content, this
+  produces the rules); personality still undefined -> brand/archetype-finder
+  first.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/wireframe/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/wireframe
 description: >
-  Wireframe design: layout, navigation, content hierarchy, interaction notes.
+  Designs wireframes — layout, navigation, content hierarchy, and interaction
+  notes — using Garrett's 5 Planes and information architecture, delivered as
+  an annotated spec with component references and responsive notes. TRIGGER:
+  "wireframe", "esboça a página", "estrutura da página", "low-fi layout",
+  "wireframe the dashboard", "/brand wireframe <page>". SKIP: full
+  landing-page conversion structure -> landing/page-architect
+  (conversion-driven section architecture); pixel-level brand-applied visuals
+  -> brand/mockup-generate (wireframes come first).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/ai-community/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: community/ai-community
 description: >
-  AI/tech community setup: Discord channels, roles, bots, content strategy.
+  AI/tech community setup on Discord: channel architecture, roles, bots, and
+  content strategy, delivered as an AI community blueprint with growth plan.
+  TRIGGER: "comunidade de IA", "cria um Discord de AI", "AI community",
+  "Discord for my AI product", "setup tech community", "/community ai".
+  SKIP: niche undecided or non-AI vertical -> community/niche-setup (full
+  blueprint for any niche); platform still undecided ->
+  community/platform-select (compares Discord vs Telegram vs Skool first).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/betting-setup/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: community/betting-setup
 description: >
-  Betting/trading community setup: Telegram VIP, signal delivery, tier pricing.
+  Betting/trading community setup on Telegram: VIP group structure, signal
+  delivery, bot config, and tier pricing, delivered as a launch-ready
+  blueprint. TRIGGER: "comunidade de apostas", "grupo VIP de sinais",
+  "betting community", "trading signals Telegram", "canal de tips",
+  "/community betting". SKIP: any other niche -> community/niche-setup
+  (generic niche blueprint); revenue design beyond tier pricing ->
+  community/monetize-plan (7-stream monetization with projections).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/business-model/SKILL.md

@@ -1,8 +1,15 @@
 ---
 name: community/business-model
 description: >
-  Design a community business model: purpose, ideal member, value proposition,
-  monetization, platform selection, and growth strategy.
+  Designs a community business model with the Community BMC + SPACES
+  framework: purpose, ideal member, value proposition, engagement model,
+  monetization streams, retention, platform, and 1000-true-fans math.
+  TRIGGER: "modelo de negócio da comunidade", "como ganhar dinheiro com a
+  comunidade", "community business model", "is my community viable",
+  "/community model <niche>". SKIP: company or product business model
+  canvas -> strat/bmc (general BMC, not community); executing the revenue
+  plan -> community/monetize-plan; full launch package ->
+  community/niche-setup.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/content-calendar/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/content-calendar
 description: >
-  Community content calendar: daily prompts, weekly events, monthly themes.
+  Community content calendar: daily discussion prompts, weekly events, and
+  monthly themes, delivered with engagement triggers and an event schedule.
+  TRIGGER: "calendário de conteúdo da comunidade", "o que postar no grupo",
+  "community content calendar", "daily prompts for Discord", "planeia os
+  posts da comunidade", "/community calendar <period>". SKIP: creator or
+  multi-channel publishing calendar -> content/calendar (content business
+  pipeline); marketing campaign calendar -> mkt/calendar-plan; designing one
+  event in depth -> community/events-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/events-plan/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: community/events-plan
 description: >
-  Event planning: AMA, workshop, challenge, co-working, launch party.
+  Plans a community event — AMA, workshop, challenge, co-working session, or
+  launch party — with format, agenda, promotion, and follow-up sequence.
+  TRIGGER: "organiza um AMA", "evento para a comunidade", "community event",
+  "plan a workshop for members", "desafio de 30 dias no grupo",
+  "/community event <type>". SKIP: recurring event cadence across
+  weeks/months -> community/content-calendar (owns the schedule, this owns
+  one event); events as a revenue stream -> community/monetize-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/gamification-design/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/gamification-design
 description: >
-  Design gamification: points, levels, badges, leaderboards, challenges.
+  Designs community gamification with the Octalysis framework (Yu-kai Chou):
+  points, levels, badges, leaderboards, and challenges, delivered as a
+  mechanics and rewards spec with engagement loop design. TRIGGER: "gamifica
+  a comunidade", "sistema de pontos e badges", "gamification", "leaderboard
+  for my Discord", "níveis para membros", "/community gamify". SKIP:
+  gamification as one lever inside churn prevention ->
+  community/retention-system (owns the full lifecycle loop); measuring
+  whether engagement actually moved -> community/metrics-track.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/metrics-track/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/metrics-track
 description: >
-  Community metrics: DAU/MAU, engagement rate, churn, NPS, revenue per member.
+  Tracks community health metrics — DAU/MAU, engagement rate, churn, NPS,
+  revenue per member — delivered as a traffic-light health dashboard.
+  TRIGGER: "métricas da comunidade", "a comunidade está saudável?",
+  "community metrics", "engagement rate do Discord", "track member churn",
+  "/community metrics". SKIP: acting on churn signals ->
+  community/retention-system (interventions, not measurement); SaaS product
+  metrics (MRR, NRR, activation) -> saas/metrics-dashboard; business ops
+  dashboards -> ops/metrics-dashboard.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/moderation/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/moderation
 description: >
-  Moderation system: rules, escalation paths, automated filters, ban policies.
+  Builds a community moderation system: rules, escalation paths, automated
+  filters, and ban policies, delivered as a moderation playbook with
+  consequences and escalation matrix. TRIGGER: "modera a comunidade",
+  "regras do grupo", "moderation rules", "ban policy", "spam no Discord",
+  "escalation path para moderadores", "/community moderate". SKIP: welcoming
+  and activating new members -> community/onboarding-flow (positive
+  first-days path, not enforcement); overall engagement design ->
+  community/retention-system.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/monetize-plan/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/monetize-plan
 description: >
-  Community monetization: membership, courses, coaching, events, affiliate, sponsors, digital.
+  Community monetization plan across the 7-stream stack — membership,
+  courses, coaching, events, affiliate, sponsorships, digital products —
+  with revenue projections per stream. TRIGGER: "monetiza a comunidade",
+  "ganhar dinheiro com o grupo", "community monetization", "membership
+  pricing", "sponsors para a comunidade", "/community monetize". SKIP: SaaS
+  product pricing -> saas/pricing-strategy (product tiers, not community
+  streams); creator/content revenue -> content/monetization-plan; the full
+  viability question -> community/business-model.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/niche-setup/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: community/niche-setup
 description: >
-  Full niche community setup: business model, platform, content, monetization.
+  Full niche community setup end-to-end — business model, platform choice,
+  content plan, and monetization — delivered as a complete launch-ready
+  blueprint. TRIGGER: "cria uma comunidade de <nicho>", "lança a minha
+  comunidade", "start a community from scratch", "setup de comunidade paga",
+  "build a paid community", "/community setup <niche>". SKIP: AI/tech
+  Discord vertical -> community/ai-community; betting/trading Telegram
+  vertical -> community/betting-setup; only one piece needed ->
+  community/platform-select, community/monetize-plan, or
+  community/business-model.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/onboarding-flow/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/onboarding-flow
 description: >
-  Design member onboarding: welcome DM, first 7 days, activation triggers.
+  Designs member onboarding with the Member Lifecycle (Millington): welcome
+  DM, first-7-days journey, activation triggers, automated messages, and
+  milestones with activation metrics. TRIGGER: "onboarding de membros",
+  "primeiros dias na comunidade", "welcome new members", "member
+  activation", "mensagem de boas-vindas automática", "/community onboard".
+  SKIP: SaaS product user onboarding -> saas/onboarding-optimize (product
+  activation, not community); keeping existing members engaged past week
+  one -> community/retention-system.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/platform-select/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: community/platform-select
 description: >
-  Select the right platform for your niche: Telegram, Discord, Skool, Circle, Mighty, Whop.
+  Selects the right community platform for a niche — Telegram, Discord,
+  Skool, Circle, Mighty, Whop — via a selection matrix, delivered as a
+  recommendation with comparison table and migration plan. TRIGGER: "que
+  plataforma para a comunidade", "Discord ou Telegram?", "Skool vs Circle",
+  "where should I host my community", "migrar a comunidade de plataforma",
+  "/community platform <niche>". SKIP: platform already chosen and needs
+  setup -> community/niche-setup (or community/ai-community for AI Discord);
+  viability question first -> community/business-model.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/retention-system/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: community/retention-system
 description: >
-  Design member retention system with engagement loops, gamification,
-  and churn prevention triggers.
+  Designs a member retention system: 6-stage lifecycle triggers, 7 retention
+  habits, churn-signal responses (7/14/30-day win-backs), and gamification
+  elements. TRIGGER: "reter membros", "os membros estão a sair", "member
+  retention", "reduce community churn", "engagement loops", "win-back de
+  membros", "/community retain". SKIP: SaaS revenue churn diagnosis ->
+  saas/churn-analysis (cohorts and MRR, not members); designing the
+  points/badges system itself -> community/gamification-design; measuring
+  health -> community/metrics-track.
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/content/skills/ai-workflow/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/ai-workflow
 description: >
-  AI content workflow: ideation, drafting, editing, formatting with AI assistance.
+  AI-augmented content workflow: ideation, drafting, editing, and formatting
+  with AI assistance plus human review checkpoints. TRIGGER: "usa AI para
+  criar conteúdo", "draft this with AI", "AI content workflow", "edita este
+  rascunho com AI", "acelera a produção de conteúdo", "/content ai". SKIP:
+  building the full pillar-to-derivatives operating system ->
+  content/content-system (owns strategy and cadence, not AI-assisted
+  drafting); automating business processes or integrations ->
+  ops/workflow-automate (non-content automation).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/analytics/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/analytics
 description: >
-  Content analytics: views, engagement, saves, shares, CTR, revenue attribution.
+  Content performance analytics: views, engagement, saves, shares, CTR, and
+  revenue attribution, delivered as a report with top/bottom performers and
+  optimization actions. TRIGGER: "como está a performance do conteúdo",
+  "content analytics", "quais posts tiveram mais engagement", "analisa as
+  views", "revenue por conteúdo", "/content analytics". SKIP: cross-channel
+  campaign metrics -> marketing/analytics-report (owns campaign reporting);
+  page-to-purchase conversion metrics -> landing/funnel-metrics (owns funnel
+  conversion, not content engagement).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/calendar/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/calendar
 description: >
-  Content calendar: weekly themes, pillar assignments, derivative scheduling.
+  Content calendar planning: weekly themes, pillar assignments, and derivative
+  scheduling mapped from pillar to platform-native pieces. TRIGGER:
+  "calendário de conteúdo", "content calendar", "planeia a semana de posts",
+  "publishing schedule", "agenda de publicações", "/content calendar". SKIP:
+  campaign and promo timing across channels -> marketing/calendar-plan (owns
+  marketing campaign calendars); community-space programming ->
+  community/content-calendar (owns community engagement calendars); building
+  the whole strategy, not one calendar -> content/content-system.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/content-system/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: content/content-system
 description: >
-  Set up a Content Operating System: pillar content strategy, batching workflow,
-  1-to-30+ repurposing pipeline, calendar, and analytics tracking.
+  Sets up a full Content Operating System: pillar content strategy (GaryVee
+  model), weekly batching workflow, 1-to-30+ repurposing pipeline, calendar
+  template, and metrics tracking. TRIGGER: "monta o meu sistema de conteúdo",
+  "content operating system", "estratégia de conteúdo completa", "pillar
+  content strategy", "content OS", "/content system". SKIP: only scheduling an
+  existing strategy -> content/calendar (one calendar, not the system); only
+  atomizing one piece -> content/repurpose-plan (single pillar, not the
+  operating system).
 allowed-tools: [Read, Write, Edit, Agent, WebFetch]
 ---
 

package/departments/content/skills/hook-write/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: content/hook-write
 description: >
-  Write hooks for the first 3 seconds of any content. 7 hook types with
-  templates and A/B testing variants.
+  Writes hooks for the first 3 seconds of any content: generates 10+ variants
+  across 7 hook types (controversy, curiosity gap, pain point, result,
+  counter-intuitive, story, direct value), scores them, and formats the top 5
+  per platform. TRIGGER: "hook para reels", "escreve um hook", "opening
+  line", "primeiros 3 segundos", "hook for TikTok", "/content hook". SKIP:
+  headlines for landing pages or sales copy -> landing/headline-write
+  (conversion copy, not retention hooks); full video script ->
+  content/script-structure.
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/content/skills/monetization-plan/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/monetization-plan
 description: >
-  Creator monetization plan: 5 levels from ads to high-ticket.
+  Creator monetization plan: a 5-level ladder from ads and affiliates up to
+  high-ticket offers, with revenue projections per level. TRIGGER: "como
+  monetizar o meu conteúdo", "monetize my audience", "plano de monetização",
+  "creator revenue streams", "ganhar dinheiro com o canal", "/content
+  monetize". SKIP: monetizing a community or membership ->
+  community/monetize-plan (owns community revenue models); recurring product
+  pricing -> ecom/subscription-model (product pricing, not the creator
+  ladder).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/newsletter-write/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: content/newsletter-write
 description: >
-  Newsletter writing: subject line, intro hook, sections, CTA, growth tactics.
+  Newsletter writing: subject line variants, intro hook, body sections, CTA,
+  and growth tactics, delivered as a ready-to-send draft with growth
+  recommendations. TRIGGER: "escreve a newsletter", "newsletter desta
+  semana", "write a newsletter issue", "subject line para email", "edição da
+  newsletter", "/content newsletter". SKIP: automated multi-email nurture or
+  sales sequences -> marketing/email-sequence (funnel automation, not
+  editorial issues); cold outbound prospecting email -> marketing/cold-email.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/platform-optimize/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: content/platform-optimize
 description: >
-  Platform-specific optimization: signals, formats, timing per algorithm.
+  Platform-specific content optimization: algorithm signals, best-performing
+  formats, and posting times for a given platform, delivered as a platform
+  guide. TRIGGER: "otimiza para o Instagram", "how does the TikTok algorithm
+  work", "melhor hora para publicar", "platform algorithm", "formatos que
+  funcionam no LinkedIn", "/content platform". SKIP: choosing WHICH platform
+  to build a community on -> community/platform-select (platform choice, not
+  optimization); overall social channel strategy -> marketing/social-strategy;
+  YouTube specifically -> content/youtube-strategy (dedicated deeper
+  playbook).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/repurpose-plan/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: content/repurpose-plan
 description: >
-  Repurpose one pillar piece into 30+ platform-native content pieces.
+  Repurposes one pillar piece into 30+ platform-native derivatives (clips,
+  posts, threads, carousels, newsletter sections) with a scheduling map.
+  TRIGGER: "reaproveita este vídeo", "repurpose this post", "transforma em
+  reels", "atomize my content", "derivados deste artigo", "/content
+  repurpose". SKIP: designing the whole pillar strategy and cadence ->
+  content/content-system (the system that produces pillars, not one piece);
+  scheduling already-made pieces -> content/calendar.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/script-structure/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/script-structure
 description: >
-  Long-form script: YouTube, podcast, webinar with retention techniques.
+  Long-form script writing for YouTube, podcast, or webinar: full script with
+  timestamps, hooks, transitions, retention techniques, and CTA placement
+  (Hook-Bridge-Body-CTA). TRIGGER: "escreve o guião do vídeo", "video
+  script", "script para o podcast", "roteiro longo", "webinar script",
+  "/content script-long". SKIP: sub-60-second vertical video ->
+  content/short-form (short-form scripts and algorithm formatting);
+  channel-level positioning and packaging -> content/youtube-strategy; just
+  the opening seconds -> content/hook-write.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/short-form/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/short-form
 description: >
-  Short-form content: Reels, TikTok, Shorts optimized for each platform's algorithm.
+  Short-form content creation: 5 Reels/TikTok/Shorts scripts with hooks,
+  platform-native formatting, and a posting schedule, optimized for each
+  platform's algorithm. TRIGGER: "cria uns reels", "TikTok script", "ideias
+  para shorts", "conteúdo curto", "vertical video", "/content short". SKIP:
+  10+ minute video or podcast script -> content/script-structure (long-form
+  retention structure); engineering shareability of a piece ->
+  content/viral-design (STEPPS scoring, not production); hooks alone ->
+  content/hook-write.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/thumbnail-package/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: content/thumbnail-package
 description: >
-  Thumbnail and title packaging: 5+ variants for A/B testing.
+  Thumbnail and title packaging (MrBeast method): 5+ title/thumbnail variants
+  for A/B testing with curiosity-gap scoring. TRIGGER: "faz a thumbnail",
+  "thumbnail ideas", "título para o vídeo", "video title and thumbnail",
+  "packaging do vídeo", "/content thumbnail". SKIP: full channel strategy
+  where packaging is one of seven deliverables -> content/youtube-strategy;
+  spoken or written hooks for the content itself -> content/hook-write;
+  actual image asset production -> brand/mockup-generate (visual design
+  execution).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/content/skills/viral-design/SKILL.md

@@ -1,8 +1,14 @@
 ---
 name: content/viral-design
 description: >
-  Design viral content using Jonah Berger's STEPPS framework. Score content
-  against 6 viral triggers before publishing.
+  Designs viral content with Jonah Berger's STEPPS framework: scores topic
+  and final piece against the 6 triggers (Social Currency, Triggers, Emotion,
+  Public, Practical Value, Stories), minimum 6/12 to publish. TRIGGER:
+  "conteúdo viral", "make this go viral", "porque não viralizou", "viral
+  content ideas", "quero que isto seja partilhado", "/content viral". SKIP:
+  producing the actual short-form scripts -> content/short-form (production,
+  not virality scoring); only the opening hook -> content/hook-write (hooks
+  are one step of this flow).
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---