arkaos 4.7.0 → 4.8.0

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

package/departments/org/skills/principles-audit/SKILL.md

@@ -1,9 +1,14 @@
 ---
 name: org/principles-audit
 description: >
-  Annual audit against the 10 Principles of Effective Organizations. Score 1-5
-  per principle, prioritise the 2-3 weakest, and produce a quarterly plan. The
-  three make-or-break principles are Empowerment, Leadership culture, Reward.
+  Annual org-health audit against the 10 Principles of Effective
+  Organizations: score 1-5 per principle with evidence, flag the make-or-break
+  three (Empowerment, Reward, Leadership culture), and produce a quarterly
+  improvement plan with owners. TRIGGER: "auditoria organizacional", "org
+  health check", "audit the organization", "10 princípios", "principles
+  audit", "/org principles-audit". SKIP: values lived-vs-stated assessment ->
+  lead/culture-audit (culture, not org effectiveness); acting on a
+  weak-structure finding -> org/org-design (the redesign itself).
 allowed-tools: [Read, Write, Edit, Agent]
 ---
 

package/departments/org/skills/remote-setup/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/remote-setup
 description: >
-  Remote work setup: async communication, tool stack, rituals, culture preservation.
+  Builds a remote-work playbook: async communication norms, tool stack,
+  rituals, policies, culture preservation, and success metrics. TRIGGER:
+  "passar a equipa a remoto", "setup de trabalho remoto", "remote work
+  playbook", "async-first", "políticas de teletrabalho", "/org remote". SKIP:
+  only trimming the meeting load -> org/meeting-optimize (one slice of remote
+  hygiene); defining the values the remote culture must preserve ->
+  org/culture-define.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/sop-process/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/sop-process
 description: >
-  SOP creation: step-by-step procedures with roles, tools, exceptions.
+  Creates a Standard Operating Procedure: numbered step-by-step procedure with
+  roles, tools, exceptions, ownership, and a review schedule (SOP Lifecycle).
+  TRIGGER: "documenta este processo", "cria um SOP de RH", "SOP for
+  onboarding", "procedimento passo-a-passo", "process documentation", "/org
+  sop <process>". SKIP: operational and Lean procedures owned by the ops
+  department -> ops/sop-create (same artifact, ops-domain processes);
+  automating the process instead of documenting it -> ops/workflow-automate.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/org/skills/team-assess/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: org/team-assess
 description: >
-  Team assessment: topology type, cognitive load, skill gaps, interaction patterns.
+  Assesses a single team with Team Topologies: topology type, cognitive load,
+  skill gaps, and interaction patterns, delivering a topology recommendation
+  and improvement actions. TRIGGER: "avalia esta equipa", "a equipa está
+  sobrecarregada", "team assessment", "cognitive load da equipa", "skill
+  gaps", "/org assess <team>". SKIP: restructuring the whole organization ->
+  org/org-design (multi-team redesign); trust, conflict, or accountability
+  dysfunction -> lead/team-health (Lencioni Five Dysfunctions).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/pm/skills/agile-po/SKILL.md

@@ -1,9 +1,16 @@
 ---
 name: pm/agile-po
 description: >
-  Agile product ownership: user story writing, acceptance criteria,
-  sprint planning, epic breakdown, backlog prioritization, velocity tracking.
-  INVEST-compliant stories with Given-When-Then acceptance criteria.
+  Full agile product ownership: INVEST user stories with Given-When-Then
+  acceptance criteria, epic breakdown into sprint-sized stories, sprint
+  capacity planning, and value/effort backlog prioritization with velocity
+  tracking. TRIGGER: "faz de product owner", "parte este épico em stories",
+  "break down this epic", "plan the sprint and prioritize", "prioriza o
+  backlog e planeia o sprint", "/pm agile-po". SKIP: writing a single
+  standalone story -> pm/story-write (dedicated story-splitting flow);
+  sprint ceremony alone -> pm/sprint-plan (goal + commitment focus);
+  RICE-scored refinement -> pm/backlog-groom (grooming, not the full PO
+  cycle).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
 ---
 

package/departments/pm/skills/backlog-groom/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: pm/backlog-groom
 description: >
-  Backlog grooming: prioritize with RICE, refine stories, ensure INVEST criteria.
+  Backlog grooming with RICE prioritization: scores and ranks items,
+  refines stories to INVEST-ready state, and delivers a prioritized backlog
+  with ready items. TRIGGER: "groom the backlog", "faz grooming do
+  backlog", "prioriza o backlog", "RICE score these items", "refina estas
+  stories", "/pm backlog". SKIP: writing new stories from scratch ->
+  pm/story-write (creation, not refinement); selecting groomed items into a
+  sprint -> pm/sprint-plan (commitment happens there); full PO cycle with
+  epics and velocity -> pm/agile-po.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/pm/skills/discovery-plan/SKILL.md

@@ -1,8 +1,16 @@
 ---
 name: pm/discovery-plan
 description: >
-  Product discovery using Teresa Torres' Opportunity Solution Tree.
-  Map outcomes to opportunities to solutions to experiments.
+  Product discovery with Teresa Torres' Opportunity Solution Tree: maps a
+  desired outcome to opportunities, solutions, assumptions, and
+  experiments, on a dual-track weekly interview cadence. TRIGGER: "product
+  discovery", "plano de discovery", "opportunity solution tree", "que
+  problema devemos resolver", "which opportunities should we pursue",
+  "valida esta ideia com clientes", "/pm discover". SKIP: goal already set
+  and mapping deliverables to it -> pm/impact-map (goal decomposition, not
+  opportunity exploration); sequencing validated bets over quarters ->
+  pm/roadmap-build; shaping one chosen solution for the betting table ->
+  pm/shape-pitch.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/pm/skills/estimate-forecast/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: pm/estimate-forecast
 description: >
-  Estimation and forecasting: story points, throughput, Monte Carlo probability.
+  Estimation and delivery forecasting: story points, throughput analysis,
+  and Monte Carlo simulation producing confidence intervals (50th/85th/95th
+  percentile) for "when will it be done". TRIGGER: "quando fica pronto",
+  "estima este backlog", "when will this ship", "forecast the release
+  date", "Monte Carlo forecast", "/pm estimate". SKIP: sizing items during
+  refinement -> pm/backlog-groom (estimation inside grooming, not
+  probabilistic forecasting); committing capacity for a single sprint ->
+  pm/sprint-plan; quantifying code-quality drag on delivery ->
+  dev/tech-debt (debt economics, not schedule forecasting).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/pm/skills/impact-map/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: pm/impact-map
 description: >
-  Impact mapping: WHY → WHO → HOW → WHAT connecting goals to deliverables.
+  Impact mapping (Gojko Adzic): connects a business goal through actors and
+  behaviour changes to concrete deliverables — WHY -> WHO -> HOW -> WHAT —
+  so every deliverable traces back to the goal. TRIGGER: "impact map",
+  "mapa de impacto", "liga o objetivo às entregas", "why are we building
+  this", "que features suportam este objetivo", "/pm impact". SKIP:
+  exploring unknown customer opportunities -> pm/discovery-plan
+  (opportunity tree, not goal decomposition); turning mapped deliverables
+  into a timeline -> pm/roadmap-build; defining the measurable objectives
+  themselves -> leadership/okr-define.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/pm/skills/kanban-setup/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: pm/kanban-setup
 description: >
-  Kanban board setup: columns, WIP limits, policies, flow metrics.
+  Kanban system design (Anderson method): board columns, WIP limits,
+  explicit policies, and flow metrics with a measurement plan. TRIGGER:
+  "setup kanban", "monta o quadro kanban", "define WIP limits", "limites de
+  WIP", "melhora o fluxo da equipa", "/pm kanban". SKIP: timeboxed Scrum
+  cadence with sprint goals -> pm/sprint-plan (iterations, not continuous
+  flow); running the daily sync on the board -> pm/standup-run;
+  probabilistic delivery dates from throughput -> pm/estimate-forecast.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---