feat: integrate saas-metrics-coach, add finance commands, remove seek-and-analyze-video

- Integrate saas-metrics-coach into cs-financial-analyst agent with SaaS health
  and unit economics workflows
- Add /financial-health and /saas-health slash commands
- Add /update-docs repo command for post-creation sync pipeline
- Remove seek-and-analyze-video skill (requires paid external API)
- Update all documentation (CLAUDE.md, README.md, docs site, marketplace)
- Sync Codex CLI (150 skills), Gemini CLI (207 items), fix count consistency
- Regenerate 206 MkDocs pages, fix docs/index.md meta 170→171,
  getting-started.md finance bundle 1→2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: alirezarezvani

.claude-plugin/marketplace.json

@@ -4,11 +4,11 @@
     "name": "Alireza Rezvani",
     "url": "https://alirezarezvani.com"
   },
-  "description": "149 production-ready skill packages for Claude AI across 9 domains: marketing (42), engineering (23+25), C-level advisory (28), regulatory/QMS (12), product (8), project management (6), business growth (4), and finance (1). Includes 224 Python tools, 341 reference documents, 14 agents, and 12 slash commands.",
+  "description": "150 production-ready skill packages for Claude AI across 9 domains: marketing (42), engineering (23+25), C-level advisory (28), regulatory/QMS (12), product (8), project management (6), business growth (4), and finance (2). Includes 240 Python tools, 343 reference documents, 14 agents, and 14 slash commands.",
   "homepage": "https://github.com/alirezarezvani/claude-skills",
   "repository": "https://github.com/alirezarezvani/claude-skills",
   "metadata": {
-    "description": "149 production-ready skill packages across 9 domains with 224 Python tools, 341 reference documents, 14 agents, and 12 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.",
+    "description": "150 production-ready skill packages across 9 domains with 240 Python tools, 343 reference documents, 14 agents, and 14 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.",
     "version": "2.1.2"
   },
   "plugins": [
@@ -177,7 +177,7 @@
     {
       "name": "finance-skills",
       "source": "./finance",
-      "description": "1 finance skill: financial analyst with ratio analysis, DCF valuation, budgeting, and forecasting. 4 Python automation tools.",
+      "description": "2 finance skills: financial analyst (ratio analysis, DCF valuation, budgeting, forecasting) and SaaS metrics coach (ARR, MRR, churn, CAC, LTV, NRR, Quick Ratio, projections). 7 Python automation tools.",
       "version": "2.1.2",
       "author": {
         "name": "Alireza Rezvani"
@@ -187,7 +187,14 @@
         "dcf",
         "valuation",
         "budgeting",
-        "forecasting"
+        "forecasting",
+        "saas",
+        "metrics",
+        "arr",
+        "mrr",
+        "churn",
+        "ltv",
+        "cac"
       ],
       "category": "finance"
     },

.claude/commands/README.md

@@ -19,6 +19,7 @@
 ```
 /review         → Run local quality checks
 /security-scan  → Run security validation
+/update-docs    → Post-creation sync (CLI platforms, marketplace, docs, GitHub Pages)
 ```
 
 ---

.claude/commands/update-docs.md

@@ -0,0 +1,228 @@
+---
+description: Update all the documentation related files.
+---
+
+After completing any skill creation, agent creation, or command creation in this repository, run the full post-creation sync pipeline below. Execute every step — never skip a task. If something is unclear or a step fails, ask the user for guidance before continuing.
+
+---
+
+## Step 1: Inventory what changed
+
+Scan the working tree to identify what was added, modified, or deleted:
+
+```bash
+git status --short
+```
+
+Classify each change:
+- **New skill** — a new folder containing `SKILL.md` under a domain directory
+- **New agent** — a new `.md` file under `agents/`
+- **New command** — a new `.md` file under `commands/`
+- **Modified skill/agent/command** — updated existing files
+- **Deleted skill/agent/command** — removed files
+
+Report the inventory to the user before proceeding.
+
+---
+
+## Step 2: Cross-platform CLI sync
+
+Ensure all platforms have compatible versions of every skill, agent, and command.
+
+### 2a. Codex CLI
+
+Run the Codex sync script to regenerate symlinks and the skills index:
+
+```bash
+python3 scripts/sync-codex-skills.py --verbose
+```
+
+Verify the output: check `.codex/skills-index.json` for correct `total_skills` count and that new skills appear in the index.
+
+### 2b. Gemini CLI
+
+Run the Gemini sync script:
+
+```bash
+python3 scripts/sync-gemini-skills.py --verbose
+```
+
+Verify: check `.gemini/skills-index.json` for correct total count. New skills, agents, and commands should all have corresponding entries and symlinks under `.gemini/skills/`.
+
+### 2c. OpenClaw
+
+Verify that `scripts/openclaw-install.sh` will pick up the new skills. The install script uses the same directory structure, so no separate sync is needed — but confirm the new skill directories are not excluded by any filter in the script.
+
+Report sync results (skill counts per platform) to the user.
+
+---
+
+## Step 3: Claude Code plugin marketplace
+
+### 3a. Domain-level plugin.json
+
+For each domain that had changes, update the domain's `.claude-plugin/plugin.json`:
+- Update `description` with accurate skill/tool/reference counts
+- Update `version` if needed
+- Verify `source` paths are correct
+
+Domain plugin.json locations:
+- `marketing-skill/.claude-plugin/plugin.json`
+- `engineering-team/.claude-plugin/plugin.json`
+- `engineering/.claude-plugin/plugin.json`
+- `product-team/.claude-plugin/plugin.json`
+- `c-level-advisor/.claude-plugin/plugin.json`
+- `project-management/.claude-plugin/plugin.json`
+- `ra-qm-team/.claude-plugin/plugin.json`
+- `business-growth/.claude-plugin/plugin.json`
+- `finance/.claude-plugin/plugin.json`
+
+### 3b. Root marketplace.json
+
+Update `.claude-plugin/marketplace.json`:
+- Update the top-level `metadata.description` with accurate total counts (skills, tools, references, agents, commands)
+- If a new individual skill plugin entry is needed (for standalone install), add it to the `plugins` array following the existing pattern
+- Update `keywords` arrays if new domains or capabilities were added
+- Verify all `source` paths point to valid directories
+
+---
+
+## Step 4: Update documentation files
+
+### 4a. Root CLAUDE.md
+
+Update `/CLAUDE.md` (the root project instructions):
+- **Current Scope** line: update skill, tool, reference, agent, and command counts
+- **Repository Structure** comment counts (agents, commands, skills per domain)
+- **Navigation Map** table: verify all domain entries are current
+- **Current Version** section: add a bullet if significant changes were made
+- **Roadmap** section: update counts if needed
+
+### 4b. Domain-level CLAUDE.md files
+
+For each domain that had changes, update its `CLAUDE.md`:
+- Skill count and list
+- Script/tool count
+- Agent references
+- Command references
+- Any new cross-domain integrations
+
+Domain CLAUDE.md locations:
+- `agents/CLAUDE.md`
+- `marketing-skill/CLAUDE.md`
+- `product-team/CLAUDE.md`
+- `engineering-team/CLAUDE.md`
+- `c-level-advisor/CLAUDE.md`
+- `project-management/CLAUDE.md`
+- `ra-qm-team/CLAUDE.md`
+- `business-growth/CLAUDE.md`
+- `finance/CLAUDE.md`
+- `standards/CLAUDE.md`
+- `templates/CLAUDE.md`
+
+### 4c. Root README.md
+
+Update `/README.md`:
+- Badge counts (Skills, Agents, Commands)
+- Tagline/intro paragraph skill count
+- Skills Overview table (domain rows with correct counts)
+- Quick Install section (install commands, skill counts in comments)
+- Python Analysis Tools section (tool count, add examples for new tools)
+- FAQ section (update any counts mentioned)
+
+### 4d. docs/index.md (GitHub Pages homepage)
+
+Update `docs/index.md`:
+- `description` meta tag
+- Hero subtitle skill count
+- Grid cards (skills, tools, agents, commands counts)
+- Domain cards (skill counts per domain, links)
+
+### 4e. docs/getting-started.md
+
+Update `docs/getting-started.md`:
+- `description` meta tag
+- Available Bundles table (skill counts per bundle)
+- Python Tools section (tool count)
+- FAQ answers (any count references)
+
+---
+
+## Step 5: Regenerate GitHub Pages
+
+Run the docs generation script to create/update all MkDocs pages:
+
+```bash
+python3 scripts/generate-docs.py
+```
+
+This generates pages for:
+- Every skill (from SKILL.md files)
+- Every agent (from agents/*.md)
+- Every command (from commands/*.md)
+- Index pages for skills, agents, and commands sections
+
+### 5a. Update mkdocs.yml navigation
+
+Open `mkdocs.yml` and update the `nav:` section:
+- Add new skill pages under the correct domain section
+- Add new agent pages under the Agents section
+- Add new command pages under the Commands section
+- Update `site_description` with current counts
+
+### 5b. Verify the build
+
+```bash
+python3 -m mkdocs build 2>&1 | tail -5
+```
+
+The build should complete without errors. Warnings about relative links in SKILL.md files are expected and can be ignored (they reference skill-internal paths like `references/` and `scripts/`).
+
+Report the build result and page count to the user.
+
+---
+
+## Step 6: Consistency verification
+
+Run a final consistency check across all updated files:
+
+1. **Count consistency** — Verify the same skill/agent/command/tool counts appear in:
+   - Root CLAUDE.md
+   - Root README.md
+   - docs/index.md
+   - docs/getting-started.md
+   - .claude-plugin/marketplace.json
+
+2. **Path validation** — Verify all `source` paths in marketplace.json point to existing directories
+
+3. **New script verification** — If new Python scripts were added, verify they run:
+   ```bash
+   python3 path/to/new/script.py --help
+   ```
+
+4. **Frontmatter check** — Verify all new SKILL.md, agent, and command files have valid YAML frontmatter with at minimum `name` and `description` fields
+
+Report any inconsistencies found and fix them before finishing.
+
+---
+
+## Step 7: Summary report
+
+Present a summary to the user:
+
+| Item | Status |
+|------|--------|
+| New skills added | [list] |
+| New agents added | [list] |
+| New commands added | [list] |
+| Codex CLI sync | count |
+| Gemini CLI sync | count |
+| OpenClaw compatible | yes/no |
+| Marketplace updated | yes/no |
+| CLAUDE.md files updated | [count]/[total] |
+| README.md updated | yes/no |
+| GitHub Pages regenerated | [page count] pages |
+| MkDocs build | pass/fail |
+| Consistency check | pass/fail |
+
+Ask the user if they want to commit and push the changes.

.codex/skills-index.json

@@ -3,7 +3,7 @@
   "name": "claude-code-skills",
   "description": "Production-ready skill packages for AI agents - Marketing, Engineering, Product, C-Level, PM, and RA/QM",
   "repository": "https://github.com/alirezarezvani/claude-skills",
-  "total_skills": 151,
+  "total_skills": 150,
   "skills": [
     {
       "name": "contract-and-proposal-writer",
@@ -713,12 +713,6 @@
       "category": "marketing",
       "description": "When the user wants to implement, audit, or validate structured data (schema markup) on their website. Use when the user mentions 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' or 'structured data errors in Search Console.' Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility. NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture)."
     },
-    {
-      "name": "seek-and-analyze-video",
-      "source": "../../marketing-skill/seek-and-analyze-video",
-      "category": "marketing",
-      "description": "Video intelligence and content analysis using Memories.ai LVMM. Discover videos on TikTok, YouTube, Instagram by topic or creator. Analyze video content, summarize meetings, build searchable knowledge bases across multiple videos. Use for video research, competitor content analysis, meeting notes, lecture summaries, or building video knowledge libraries."
-    },
     {
       "name": "seo-audit",
       "source": "../../marketing-skill/seo-audit",
@@ -939,7 +933,7 @@
       "description": "Financial analysis, valuation, and forecasting skills"
     },
     "marketing": {
-      "count": 43,
+      "count": 42,
       "source": "../../marketing-skill",
       "description": "Marketing, content, and demand generation skills"
     },

.codex/skills/seek-and-analyze-video

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "name": "gemini-cli-skills",
-  "total_skills": 204,
+  "total_skills": 207,
   "skills": [
     {
       "name": "cs-agile-product-owner",
@@ -36,7 +36,7 @@
     {
       "name": "cs-financial-analyst",
       "category": "agent",
-      "description": "Financial Analyst agent for DCF valuation, financial modeling, budgeting, and forecasting. Orchestrates finance skills. Spawn when users need financial statements analysis, valuation models, budget planning, ratio analysis, or industry benchmarking."
+      "description": "Financial Analyst agent for DCF valuation, financial modeling, budgeting, forecasting, and SaaS metrics (ARR, MRR, churn, CAC, LTV, NRR). Orchestrates finance skills. Spawn when users need financial analysis, valuation models, budget planning, ratio analysis, SaaS health checks, or unit economics projections."
     },
     {
       "name": "cs-growth-strategist",
@@ -278,6 +278,11 @@
       "category": "command",
       "description": "Build competitive analysis matrices with scoring and gap analysis. Usage: /competitive-matrix <analyze> [options]"
     },
+    {
+      "name": "financial-health",
+      "category": "command",
+      "description": "Run financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecasts. Usage: /financial-health <ratios|dcf|budget|forecast> <data.json>"
+    },
     {
       "name": "okr",
       "category": "command",
@@ -308,6 +313,11 @@
       "category": "command",
       "description": "RICE feature prioritization with scoring and capacity planning. Usage: /rice prioritize <features.csv> [options]"
     },
+    {
+      "name": "saas-health",
+      "category": "command",
+      "description": "Calculate SaaS health metrics (ARR, MRR, churn, CAC, LTV, NRR) and benchmark against industry standards. Usage: /saas-health <metrics|quick-ratio|simulate> [options]"
+    },
     {
       "name": "sprint-health",
       "category": "command",
@@ -663,6 +673,11 @@
       "category": "finance",
       "description": "Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making. Use when analyzing financial statements, building valuation models, assessing budget variances, or constructing financial projections and forecasts. Also applicable when users mention financial modeling, cash flow analysis, company valuation, financial projections, or spreadsheet analysis."
     },
+    {
+      "name": "saas-metrics-coach",
+      "category": "finance",
+      "description": "SaaS financial health advisor. Use when a user shares revenue or customer numbers, or mentions ARR, MRR, churn, LTV, CAC, NRR, or asks how their SaaS business is doing."
+    },
     {
       "name": "ab-test-setup",
       "category": "marketing",
@@ -1038,7 +1053,7 @@
       "description": "C-level resources"
     },
     "command": {
-      "count": 12,
+      "count": 14,
       "description": "Command resources"
     },
     "engineering": {
@@ -1050,7 +1065,7 @@
       "description": "Engineering-advanced resources"
     },
     "finance": {
-      "count": 2,
+      "count": 3,
       "description": "Finance resources"
     },
     "marketing": {

.gemini/skills-index.json

@@ -0,0 +1 @@
+../../../commands/financial-health.md

.gemini/skills/financial-health/SKILL.md

@@ -0,0 +1 @@
+../../../commands/saas-health.md

.gemini/skills/saas-health/SKILL.md

@@ -0,0 +1 @@
+../../../finance/saas-metrics-coach/SKILL.md