arkaos 4.7.1 → 4.8.0

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]
 ---
 

package/departments/marketing/skills/social-strategy/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: mkt/social-strategy
 description: >
-  Social media strategy: platform selection, content themes, posting cadence, engagement plan.
+  Social media strategy: platform selection, content themes, posting
+  cadence, and engagement plan (STEPPS + platform-native content).
+  TRIGGER: "estratégia de redes sociais", "social media strategy", "em
+  que plataformas apostar", "plano para Instagram/LinkedIn", "cadência de
+  posts", "/mkt social <topic>". SKIP: the week-by-week publishing
+  schedule -> mkt/calendar-plan (executes this strategy); engineering a
+  piece to go viral -> content/viral-design; per-platform algorithm
+  optimisation -> content/platform-optimize.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/bottleneck-find/SKILL.md

@@ -1,8 +1,12 @@
 ---
 name: ops/bottleneck-find
 description: >
-  Identify system bottleneck using Goldratt's Theory of Constraints.
-  5 Focusing Steps to find AND resolve the constraint.
+  Identifies the system constraint with Goldratt's Theory of Constraints and applies the
+  5 Focusing Steps (identify, exploit, subordinate, elevate, repeat) into a resolution
+  plan with metrics. TRIGGER: "onde está o gargalo", "bottleneck", "work keeps piling up",
+  "o processo está lento", "find the constraint", "/ops bottleneck <area>". SKIP:
+  waste elimination across a whole value stream -> ops/lean-audit (7-wastes sweep, not a
+  single-constraint hunt); defining the metrics that expose queues -> ops/metrics-dashboard.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch]
 ---
 

package/departments/ops/skills/dashboard-build/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: ops/dashboard-build
 description: >
-  Operational dashboard design: select metrics, define targets, build layout.
+  Designs an operational dashboard with Lean Analytics and OMTM: metric selection,
+  targets, data sources, alert thresholds, and layout, with in-browser verification of
+  widgets and real-time data. TRIGGER: "constrói um dashboard", "build a dashboard",
+  "painel de operações", "quero visualizar as métricas", "/ops dashboard <area>". SKIP:
+  deciding WHICH ops metrics and SLAs to track -> ops/metrics-dashboard (picks the
+  numbers; this skill builds the surface); production telemetry, logs, and tracing ->
+  dev/observability.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/gdpr-compliance/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/gdpr-compliance
 description: >
-  GDPR compliance assessment with data mapping, DPIA generation, breach response planning, and data subject rights management.
+  GDPR compliance assessment with data mapping, DPIA generation, breach response planning
+  (72-hour notification), and data subject rights workflows. TRIGGER: "GDPR", "RGPD",
+  "proteção de dados", "are we GDPR compliant", "data mapping", "DPIA", "direito ao
+  esquecimento", "/ops gdpr-compliance". SKIP: security management system or certification
+  -> ops/iso27001 (ISMS scope, not privacy law); US customer attestation -> ops/soc2-compliance;
+  enterprise risk beyond personal data -> ops/risk-management.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/gtd-setup/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/gtd-setup
 description: >
-  Personal productivity setup: GTD capture/clarify/organize/reflect/engage + PARA.
+  Sets up a personal productivity system combining GTD (capture, clarify, organize,
+  reflect, engage) with PARA organization, delivered with a weekly review checklist.
+  TRIGGER: "GTD", "setup GTD", "organiza a minha produtividade", "personal productivity
+  system", "método PARA", "estou sobrecarregado com tarefas", "/ops gtd-setup". SKIP:
+  team task boards and delivery flow -> pm/kanban-setup (team workflow, not a personal
+  system); organizing notes and knowledge -> kb/zettelkasten-process.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/integration-design/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/integration-design
 description: >
-  Integration design: connect systems via API, webhook, or iPaaS platform.
+  Designs system-to-system integrations via API, webhook, or iPaaS platform, producing a
+  spec with data flow diagram, error handling, and monitoring. TRIGGER: "integra o
+  sistema X com Y", "connect these two systems", "liga o CRM ao ERP", "integration
+  between", "webhook design", "/ops integration <systems>". SKIP: designing the API
+  contract itself -> dev/api-design (endpoint design, not cross-system wiring); building
+  the flow on an already-chosen platform -> ops/n8n-flow or ops/zapier-flow.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/iso27001/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: ops/iso27001
 description: >
-  ISO 27001 ISMS implementation, control mapping, risk treatment planning, and certification audit preparation.
+  ISO 27001 ISMS implementation: scope, Annex A control mapping, Statement of
+  Applicability, risk treatment planning, and Stage 1/2 certification audit preparation.
+  TRIGGER: "ISO 27001", "ISMS", "certificação de segurança da informação", "security
+  certification", "Statement of Applicability", "/ops iso27001". SKIP: AICPA attestation
+  for US SaaS buyers -> ops/soc2-compliance (Trust Services Criteria, not ISMS
+  certification); hands-on codebase security testing -> dev/security-audit; enterprise
+  risk beyond information security -> ops/risk-management.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/lean-audit/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/lean-audit-skill
 description: >
-  Lean audit: value stream map, identify 7 wastes, calculate waste elimination ROI.
+  Runs a Lean audit: maps the value stream, identifies the 7 wastes, and calculates
+  waste-elimination ROI into an improvement roadmap. TRIGGER: "auditoria lean", "lean
+  audit", "elimina desperdício", "value stream map", "este processo tem muito
+  desperdício", "/ops lean-audit". SKIP: diagnosing one choke point -> ops/bottleneck-find
+  (single constraint via Theory of Constraints, not a full waste sweep); ISO 9001 quality
+  system, CAPA and internal audits -> ops/quality-management.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/metrics-dashboard/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/metrics-dashboard
 description: >
-  Operational metrics dashboard: throughput, lead time, error rate, SLAs.
+  Defines the operational metrics system — throughput, lead time, error rate, SLAs —
+  producing a spec with the OMTM, targets, and alerting rules. TRIGGER: "métricas
+  operacionais", "define os KPIs de operações", "track SLAs", "operational metrics",
+  "OMTM", "/ops metrics". SKIP: designing and rendering the dashboard surface ->
+  ops/dashboard-build (layout and widgets; this skill picks the numbers); production
+  telemetry and tracing -> dev/observability.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/n8n-flow/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/n8n-flow
 description: >
-  n8n workflow design: AI nodes, webhooks, branching, error handling.
+  Designs n8n workflows — AI/LangChain nodes, webhooks, branching, error handling — and
+  validates deployed flows via event-driven monitoring of execution logs. TRIGGER: "cria
+  um workflow n8n", "n8n flow", "automatiza com n8n", "AI workflow in n8n", "self-hosted
+  automation", "/ops n8n <flow>". SKIP: automation platform not yet chosen ->
+  ops/workflow-automate (selects n8n vs Zapier vs Make first); Zapier-specific builds ->
+  ops/zapier-flow.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/operations/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: arka-operations
 description: >
-  Operations department. Task management via ClickUp, email drafting via Gmail, calendar
-  management via Google Calendar, meeting scheduling and agenda preparation, invoice generation,
-  process automation with SOP creation, operational reports, client onboarding checklists,
-  daily standups, and multi-platform messaging (Slack, Discord, WhatsApp, Teams). Manages
-  notification channels and broadcasts. All output saved to Obsidian vault.
-  Use when user says "ops", "tasks", "email", "calendar", "automate", "invoice", "meeting",
-  "workflow", "process", "schedule", "channel", "notify", "broadcast", "onboard client",
-  "standup", "slack", "discord", "whatsapp", "teams", or any operational task.
+  Operations department orchestrator (Sofia COO squad): ClickUp tasks, Gmail email
+  drafting, Google Calendar and meeting prep, invoices, operational reports, client
+  onboarding, daily standups, and multi-platform notifications/broadcasts (Slack,
+  Discord, WhatsApp, Teams), with all output saved to Obsidian. TRIGGER: "trata das
+  minhas tasks", "envia um email", "agenda uma reunião", "invoice for client X", "daily
+  standup", "/ops <command>". SKIP: designing a reusable automation on n8n/Zapier/Make ->
+  ops/workflow-automate (flow design, not day-to-day execution); writing a formal
+  procedure document -> ops/sop-create.
 ---
 
 # Operations Department — ARKA OS

package/departments/ops/skills/quality-management/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/quality-management
 description: >
-  Quality management system design, process improvement, internal audit management, and management review per ISO 9001.
+  Designs and assesses a quality management system per ISO 9001:2015 — QMS phases (PDCA),
+  quality KPIs, internal audit program, CAPA process, and management review. TRIGGER:
+  "ISO 9001", "sistema de gestão da qualidade", "QMS", "auditoria interna", "CAPA",
+  "non-conformity process", "/ops quality-management". SKIP: eliminating process waste ->
+  ops/lean-audit (7 wastes and value stream, not a management system); reviewing code
+  quality -> dev/code-review; enterprise risk framework -> ops/risk-management.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/risk-management/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: ops/risk-management
 description: >
-  Enterprise risk identification, assessment, treatment, and monitoring using ISO 31000 and COSO ERM frameworks.
+  Enterprise risk identification, assessment (5x5 matrix), treatment, and monitoring
+  using ISO 31000 and COSO ERM, producing a risk register with owners and residual
+  scores. TRIGGER: "gestão de risco", "risk assessment", "avalia os riscos", "risk
+  register da empresa", "risk appetite", "/ops risk-management". SKIP: project-scoped
+  risk log -> pm/risk-register (single project, not enterprise ERM); information-security
+  risk for certification -> ops/iso27001; imagining failure modes before a launch ->
+  strategy/premortem.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/soc2-compliance/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: ops/soc2-compliance
 description: >
-  SOC 2 readiness assessment, Trust Services Criteria mapping, control matrix generation, evidence collection, and audit preparation.
+  SOC 2 Type I/II readiness assessment: Trust Services Criteria mapping, control matrix
+  generation, evidence collection planning, and audit preparation with readiness scoring.
+  TRIGGER: "SOC 2", "SOC2", "Trust Services Criteria", "auditoria SOC 2", "clientes
+  enterprise pedem SOC 2", "vendor security questionnaire", "/ops soc2-compliance". SKIP:
+  international ISMS certification -> ops/iso27001 (ISO route, not AICPA attestation); EU
+  personal-data obligations -> ops/gdpr-compliance; technical vulnerability testing ->
+  dev/security-audit.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/sop-create/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/sop-create
 description: >
-  Create a Standard Operating Procedure: steps, roles, tools, exceptions, review cycle.
+  Creates a Standard Operating Procedure: numbered steps, RACI roles, tools, exceptions,
+  and review cycle, following the SOP Lifecycle and Lean. TRIGGER: "cria um SOP",
+  "documenta o processo", "create SOP", "standard operating procedure", "procedimento
+  operacional", "/ops sop <process>". SKIP: automating the process instead of documenting
+  it -> ops/workflow-automate (a running flow, not a document); team delivery process and
+  ceremonies -> pm/kanban-setup or pm/sprint-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/ops/skills/update/SKILL.md

@@ -1,6 +1,13 @@
 ---
 name: arka-update
-description: ArkaOS project sync orchestrator. Detects what changed in core since last sync and updates all ecosystem skills, MCPs, settings, and project descriptors.
+description: >
+  ArkaOS project sync orchestrator: detects what changed in core since the last sync and
+  updates ecosystem skills, MCP configs, settings, and project descriptors via the hybrid
+  Python engine plus AI subagent. TRIGGER: "/arka update", "sync projects", "atualiza os
+  projetos", "update ArkaOS projects", or when SessionStart shows "[arka:update-available]";
+  run AFTER `npx arkaos@latest update`. SKIP: updating the core itself -> `npx
+  arkaos@latest update` in the terminal (this skill only syncs projects); day-to-day
+  operational requests -> ops/operations.
 ---
 
 # /arka update — Project Sync Engine

package/departments/ops/skills/workflow-automate/SKILL.md

@@ -1,8 +1,13 @@
 ---
 name: ops/workflow-automate
 description: >
-  Design workflow automations using n8n, Zapier, or Make.
-  Selects the right platform, designs the flow, handles errors.
+  Designs workflow automations end to end: selects the right platform (n8n, Zapier, or
+  Make), applies the matching design pattern, and specifies mandatory error handling
+  (retries, dead letter queue, alerts, idempotency). TRIGGER: "automatiza este processo",
+  "automate this workflow", "cria uma automação", "que ferramenta de automação uso",
+  "/ops workflow <process>". SKIP: platform already fixed -> ops/n8n-flow or
+  ops/zapier-flow (platform-specific step design); code build-test-deploy pipelines ->
+  dev/ci-cd-pipeline (software delivery, not business-process automation).
 allowed-tools: [Read, Write, Edit, Agent, WebFetch]
 ---
 

package/departments/ops/skills/zapier-flow/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: ops/zapier-flow
 description: >
-  Zapier workflow design: trigger selection, multi-step actions, error handling.
+  Designs Zapier workflows: trigger selection, multi-step actions, filters, and error
+  notifications, delivered as a Zap spec. TRIGGER: "cria um Zap", "Zapier flow",
+  "automatiza com Zapier", "liga estas apps no Zapier", "connect apps with Zapier",
+  "/ops zapier <flow>". SKIP: automation platform undecided -> ops/workflow-automate
+  (selects Zapier vs Make vs n8n first); AI-heavy or self-hosted flows -> ops/n8n-flow
+  (LangChain nodes and self-hosting that Zapier lacks).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/compensation-plan/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/compensation-plan
 description: >
-  Compensation plan: salary bands, equity/ESOP, benefits, benchmarking methodology.
+  Builds a compensation plan for a role: salary bands, equity/ESOP structure,
+  benefits, and benchmarking methodology, delivered as a total-reward package.
+  TRIGGER: "plano de compensação", "salary bands", "quanto pagar a um dev",
+  "define equity/ESOP", "benchmarking salarial", "/org comp <role>". SKIP:
+  gathering evidence and feedback for an individual's review ->
+  lead/performance-review (person-level, not band-level); full recruitment
+  package with sourcing and sell strategy -> org/hiring-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/culture-define/SKILL.md

@@ -1,9 +1,14 @@
 ---
 name: org/culture-define
 description: >
-  Culture definition — values (inversion-tested), observable behaviours,
-  reinforcing rituals, decision principles, and operationalisation in hiring
-  + performance + promotion.
+  Ships a production culture document: inversion-tested values, observable
+  behaviour maps, load-bearing ritual catalogue, decision principles, and
+  operationalisation into hiring, performance, and promotion (Netflix Culture,
+  Lencioni, Dalio). TRIGGER: "define a cultura", "valores da empresa",
+  "company values", "culture document", "decision principles", "/org culture".
+  SKIP: checking whether stated values are actually lived ->
+  lead/culture-audit (audits the existing culture; this skill defines it);
+  trust or conflict dysfunction in one team -> lead/team-health.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/decision-framework/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/decision-framework
 description: >
-  Decision framework: who decides, who's consulted, who's informed, escalation.
+  Builds a decision framework with RACI and a Decision Authority Matrix: who
+  decides, who is consulted, who is informed, authority levels, and the
+  escalation path. TRIGGER: "quem decide isto", "framework de decisão", "who
+  decides", "decision rights", "RACI da decisão", "/org decide <decision>".
+  SKIP: choosing what work to hand off and with what authority ->
+  lead/delegation-matrix (delegation of work, not decision governance);
+  stress-testing one specific decision's failure modes -> strategy/premortem.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

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

@@ -1,7 +1,13 @@
 ---
 name: org/hiring-plan
 description: >
-  Hiring plan: job scorecard, sourcing channels, interview process, sell strategy.
+  Builds a hiring plan with the Who Method (Geoff Smart): job scorecard,
+  sourcing channels, structured interview process, evaluation rubric, and sell
+  strategy. TRIGGER: "plano de contratação", "vamos contratar um <role>",
+  "hiring plan", "job scorecard", "processo de entrevistas", "/org hiring
+  <role>". SKIP: the hiring manager preparing their own scorecard and sell
+  plan -> lead/hiring-plan (leader's-seat version of the same play); ramping
+  the new hire after signing -> org/onboarding-design.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/meeting-optimize/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/meeting-optimize
 description: >
-  Meeting audit: eliminate unnecessary meetings, restructure remaining, add async.
+  Audits the meeting portfolio: eliminates unnecessary meetings, restructures
+  the ones that stay, and moves what it can to async, delivering
+  keep/kill/restructure recommendations. TRIGGER: "demasiadas reuniões",
+  "audita as reuniões", "too many meetings", "meeting audit", "passa isto para
+  async", "/org meeting audit". SKIP: running or improving the daily itself ->
+  pm/standup-run; building the full remote async operating stack ->
+  org/remote-setup (meetings are one slice of it).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/okr-cadence/SKILL.md

@@ -1,9 +1,13 @@
 ---
 name: org/okr-cadence
 description: >
-  The OKR operating cadence — quarterly cycle + weekly CFR check-ins, public
-  scoring (0.0-1.0), stretch at 60-70%, never tied to compensation, every metric
-  owned. Complements /lead okr-define (which writes OKRs). Owned by the OKR Steward.
+  Runs the OKR operating cadence (Doerr CFRs): quarterly set-score-reflect
+  cycle, weekly check-ins, public 0.0-1.0 scoring with 70% as success, never
+  tied to compensation, every KR owned. TRIGGER: "cadência de OKRs", "check-in
+  semanal de OKRs", "score the OKRs", "OKR review", "CFR", "/org okr-cadence".
+  SKIP: writing or cascading the OKRs themselves -> lead/okr-define (defines
+  the goals; this skill runs them); pay and reward questions ->
+  org/compensation-plan (OKRs must never drive comp).
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/org/skills/onboarding-design/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/onboarding-design
 description: >
-  Onboarding program: first day, first week, first month, 90-day milestones.
+  Designs an employee onboarding program per role: first day, first week,
+  first month, and 90-day milestones with buddies and success metrics.
+  TRIGGER: "programa de onboarding", "plano dos primeiros 90 dias", "employee
+  onboarding", "ramp-up do novo colaborador", "/org onboarding <role>". SKIP:
+  product or user onboarding and activation in a SaaS ->
+  saas/onboarding-optimize (customers, not employees); everything before the
+  offer is signed -> org/hiring-plan.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/org-design/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/org-design
 description: >
-  Organizational design: team topology, cognitive load, Conway's Law alignment.
+  Designs the organization with Team Topologies (Skelton/Pais): team map,
+  topology types, interaction modes, cognitive-load balance, Conway's Law
+  alignment, and an evolution path. TRIGGER: "desenha o organograma",
+  "reestruturar as equipas", "org design", "team topology", "estrutura da
+  empresa", "/org design <company>". SKIP: diagnosing one existing team rather
+  than redesigning the org -> org/team-assess; trust and conflict dysfunction
+  inside a team -> lead/team-health (Lencioni, not structure).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---