Salla PM OS — PM Skills for AI Agents

A collection of AI agent skills built for Salla Platform product managers. Works with Claude Code and any agent that supports markdown-based skills. Every skill is pre-loaded with Salla platform context — pillars, merchant segments, Saudi market regulations, competitors — so you never have to explain what Salla is.

Built for the Salla Platform PM team. Need to add a skill or improve one? Open a PR.

Run into a problem or have a question? Open an issue — we're happy to help.

What are Skills?

Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, your agent can recognize when you're working on a PM task and apply the right frameworks, Salla-specific context, and best practices automatically.

How Skills Work Together

Skills reference each other and build on shared context. The platform-pillars knowledge file is the foundation — every skill reads it first to understand Salla's 7 product pillars, merchant segments, Saudi market context (VAT, ZATCA, SAMA, PDPL), and competitors before doing anything.

                            ┌──────────────────────────────────────┐
                            │           platform-pillars           │
                            │    (read by all other skills first)  │
                            └──────────────┬───────────────────────┘
                                           │
    ┌──────────────┬────────────┬──────────┼──────────┬─────────────┬──────────────┐
    ▼              ▼            ▼          ▼          ▼             ▼              ▼
┌──────────┐ ┌──────────┐ ┌─────────┐ ┌────────┐ ┌────────┐ ┌──────────┐  ┌──────────┐
│ Merchant │ │  Define  │ │  Plan   │ │Deliver │ │Measure │ │Communicate│ │ Strategy │
│  Under-  │ │          │ │         │ │        │ │        │ │           │ │          │
│ standing │ │          │ │         │ │        │ │        │ │           │ │          │
├──────────┤ ├──────────┤ ├─────────┤ ├────────┤ ├────────┤ ├──────────┤  ├──────────┤
│merchant- │ │write-prd │ │prioritize│ │launch-│ │platform│ │status-   │  │okr-      │
│persona   │ │refine-   │ │roadmap- │ │plan    │ │metrics │ │update    │  │writer    │
│merchant- │ │spec      │ │builder  │ │retro-  │ │experi- │ │decision- │  │quarterly-│
│research  │ │          │ │sprint-  │ │facil.  │ │ment-   │ │record    │  │plan      │
│merchant- │ │          │ │scope    │ │        │ │review  │ │meeting-  │  │          │
│journey   │ │          │ │         │ │        │ │        │ │prep      │  │          │
└────┬─────┘ └────┬─────┘ └────┬────┘ └───┬────┘ └───┬────┘ └─────┬────┘  └─────┬────┘
     │            │            │           │          │            │            │
     └────────────┴──────────┬─┴───────────┴──────────┴────────────┴────────────┘
                             │
         Skills cross-reference each other:
           write-prd ↔ refine-spec ↔ launch-plan
           merchant-persona → merchant-journey → write-prd
           platform-metrics ↔ okr-writer ↔ quarterly-plan
           competitor-intel → opportunity-assessment → write-prd
           feedback-synthesis → merchant-persona → merchant-journey

See each skill's Related Skills section for the full dependency map.

Available Skills

| Skill | Description | |-------|-------------| | salla-pm | Gateway skill. Routes plain-language requests to the right skill. Start here. | | salla-setup | Onboarding wizard. Creates your knowledge base with Salla context in 3-4 interactions. | | salla-dashboard | Single-page status overview — OKR health, sprint status, launches, metrics, compliance queue. | | salla-briefing | Daily PM briefing. Scans all knowledge files and surfaces what matters today with a clear "start here." | | feedback-synthesis | Analyze merchant feedback from CS tickets, NPS, app reviews, or Slack. Arabic and English. | | competitor-intel | Research a competitor and produce a battlecard. Pre-seeded with Zid, Shopify, Youcan, Expandcart. Searches Arabic sources. | | opportunity-assessment | Validate a product idea with market sizing, merchant demand, platform feasibility, and strategic fit. Returns GO / NO-GO. | | merchant-persona | Build a Salla merchant persona. Uses Salla's 4 segments: Nano, SMB, Mid-Market, Enterprise. Saudi/GCC context built in. | | merchant-research | Plan merchant interviews or synthesize existing research. Generates bilingual interview guides. | | merchant-journey | Map a merchant's journey through a Salla flow. Arabic/mobile-first. Surfaces gaps and opportunities by pillar. | | okr-writer | Create or update OKRs for a Salla pillar. Uses canonical Salla metric definitions (GMV, Active Merchants, NPS, etc.). | | quarterly-plan | Build an execution plan for a quarter — sprint-by-sprint, compliance calendar, cross-pillar dependencies. | | write-prd | Generate a full PRD with Salla platform context, compliance pre-check, Arabic/mobile acceptance criteria, and Gherkin stories. | | refine-spec | Review a PRD for missing edge cases, weak acceptance criteria, Arabic/mobile gaps, and compliance blind spots. | | prioritize | Score features with Salla Weighted RICE — includes OKR alignment, compliance overhead, and Arabic/mobile multipliers. | | roadmap-builder | Build or update a pillar roadmap. OKR-led, compliance-honest about timelines, cross-pillar dependency mapped. | | sprint-scope | Scope a sprint from the roadmap and backlog. Accounts for Arabic QA overhead, compliance gates, and cross-pillar blocks. | | launch-plan | Generate a launch checklist with Salla-specific gates: ZATCA, Arabic copy review, mobile QA, CS briefing, rollback plan. | | retro-facilitator | Facilitate a sprint retro or blameless post-mortem. Probes Salla-specific friction: compliance slippage, Arabic QA, cross-pillar blocks. | | status-update | Generate three versions of the same update: engineering (technical), leadership (business impact), merchant-facing (Arabic-first). | | decision-record | Log a decision with context, options, rationale, compliance impact, Arabic/mobile impact, and revisit conditions. | | meeting-prep | Prepare for any Salla meeting: sprint planning, CPO review, cross-pillar sync, merchant interview, design review. | | platform-metrics | Review GMV, active merchants, orders, NPS, and pillar-specific KPIs. Seasonality-aware (Ramadan, Eid, White Friday). | | experiment-review | Analyze A/B test results with significance testing, segment breakdown by merchant tier, and a clear rollout recommendation. |

Installation

Option 1: Claude Code Plugin (Recommended)

claude plugin add bakrsabeeh/salla-pm-os

Then run setup:

/salla-setup

Option 2: Clone and Copy

git clone https://github.com/bakrsabeeh/salla-pm-os.git
cp -r salla-pm-os/skills/* .claude/skills/
cp -r salla-pm-os/knowledge-templates/* knowledge/

Option 3: Git Submodule

git submodule add https://github.com/bakrsabeeh/salla-pm-os.git .claude/salla-pm-os

Then reference skills from .claude/salla-pm-os/skills/.

Option 4: Fork and Customize

1. Fork this repository 2. Customize skills for your pillar or team's needs 3. Clone your fork into your project

Usage

Once installed, describe what you need in plain language — the gateway skill routes to the right one automatically:

"Write a PRD for a new payment method"
→ Uses write-prd skill

"What are Zid's strengths and weaknesses?"
→ Uses competitor-intel skill

"Build a persona for an SMB fashion merchant"
→ Uses merchant-persona skill

"What should I focus on today?"
→ Uses salla-briefing skill

"Score these features for next quarter"
→ Uses prioritize skill

"We're launching the new checkout flow, what do I need?"
→ Uses launch-plan skill

You can also invoke skills directly:

/write-prd checkout-payment-methods
/launch-plan merchant-onboarding-v2
/salla-briefing
/competitor-intel zid
/platform-metrics
/merchant-persona smb-fashion

Skill Categories

Core

salla-pm — Gateway: routes requests, lists skills, manages the knowledge system
salla-setup — Onboarding wizard: creates knowledge base with Salla context in 3-4 interactions
salla-dashboard — Single-page status overview
salla-briefing — Daily briefing with prioritized actions

Merchant Understanding

merchant-persona — Build research-backed Salla merchant personas
merchant-research — Plan merchant interviews and synthesize findings
merchant-journey — Map merchant journeys with pain points and opportunities

Discovery

feedback-synthesis — Synthesize merchant feedback from any source, Arabic and English
competitor-intel — Battlecards for Zid, Shopify, Youcan, Expandcart, and others
opportunity-assessment — Validate ideas with GO / NO-GO recommendation

Strategy

okr-writer — Create or update pillar OKRs with Salla's canonical metrics
quarterly-plan — Build a sprint-by-sprint execution plan for the quarter

Define

write-prd — Full PRD with compliance pre-check, Arabic/mobile ACs, Gherkin stories
refine-spec — Sharpen a spec: edge cases, Arabic/mobile gaps, compliance blind spots

Plan

prioritize — Salla Weighted RICE scoring
roadmap-builder — Pillar roadmap with OKR alignment and compliance calendar
sprint-scope — Sprint scoping with Salla-specific readiness checks

Deliver

launch-plan — Launch checklist with ZATCA, Arabic QA, mobile QA, CS prep gates
retro-facilitator — Sprint retros and blameless post-mortems

Communicate

status-update — Three-audience updates: engineering, leadership, merchant-facing (Arabic-first)
decision-record — Decision log with compliance and Arabic/mobile impact fields
meeting-prep — Agendas and talking points for any Salla PM meeting

Measure

platform-metrics — GMV, active merchants, NPS, and pillar KPI reviews
experiment-review — A/B test analysis with merchant-tier segment breakdown

Salla Context Built In

Every skill is aware of:

7 platform pillars: Store Builder, Checkout & Cart, SallaPayments, Salla Shipping, App Store, Merchant Analytics, Loyalty & CRM
4 merchant segments: Nano (0–50 orders/mo), SMB (50–500), Mid-Market (500–5K), Enterprise (5K+)
Saudi market: VAT 15%, Mada / STC Pay / Apple Pay / Tamara / Tabby, SMSA / Aramex / Naqel / J&T, ZATCA e-invoicing, SAMA, PDPL
Competitors: Zid (primary local), Shopify (global benchmark), Youcan, Expandcart, WooCommerce
Seasonality: Ramadan, Eid Al-Fitr, Eid Al-Adha, White Friday, Saudi National Day (Sep 23), 11.11
Arabic-first: RTL, bilingual (AR/EN), Hijri calendar, mobile-first (>70% of Salla merchant traffic)

Contributing

Internal Salla PM team only. Found a gap in a skill or have a new workflow to add? Open a PR.

Skills are plain markdown files — no compiled code, no build step. Read the existing skills to understand the pattern, then follow it.

License

Internal — Salla Platform PM team.

salla-merchant-understanding

Summary

Install to Claude Code