fix(catalog): show the restored skill descriptions (v4.12.2)

.gemini/skills-index.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "updated": "2026-09-27T19:17:42+00:00",
+  "updated": "2026-09-27T19:19:03+00:00",
   "total_skills": 372,
   "skills": [
     {
@@ -266,7 +266,7 @@
     },
     {
       "name": "claude-code-mastery",
-      "description": ">-",
+      "description": "Use when the user asks to \"optimize CLAUDE.md\", \"create a new skill\", \"write a custom agent\", \"configure hooks\", \"manage context window\", \"set up MCP servers\", \"scaffold a skill package\", \"analyze token budget\", \"create subagents\", \"configure permissions\", \"set up worktrees\", or \"integrate Claude Code with editors\". Covers Claude Code CLI mastery, skill authoring, context engineering, hooks automation, subagent creation, and development workflow optimization.",
       "domain": "engineering",
       "path": "engineering/claude-code-mastery/SKILL.md",
       "tools": [
@@ -1033,7 +1033,7 @@
     },
     {
       "name": "senior-cloud-architect",
-      "description": ">-",
+      "description": "Use when the user asks to \"design cloud architecture\", \"set up Terraform infrastructure\", \"optimize cloud costs\", \"plan disaster recovery\", \"configure multi-region failover\", \"audit IAM policies\", \"migrate to cloud\", \"set up VPC networking\", \"compare AWS vs GCP vs Azure\", or \"right-size cloud instances\". Expert cloud architecture covering AWS, GCP, Azure, multi-cloud strategy, cost optimization, security, and infrastructure automation.",
       "domain": "engineering",
       "path": "engineering/senior-cloud-architect/SKILL.md",
       "tools": [],
@@ -1084,7 +1084,7 @@
     },
     {
       "name": "senior-data-scientist",
-      "description": ">-",
+      "description": "Use when the user asks to \"design an experiment\", \"build a predictive model\", \"run A/B test analysis\", \"perform causal inference\", \"engineer features\", \"evaluate model performance\", \"set up MLOps pipeline\", \"analyze time series\", \"calculate sample size\", or \"deploy a model to production\". Expert data science covering statistical modeling, experimentation, causal inference, feature engineering, ML deployment, and advanced analytics with Python, R, and SQL.",
       "domain": "engineering",
       "path": "engineering/senior-data-scientist/SKILL.md",
       "tools": [
@@ -1173,7 +1173,7 @@
     },
     {
       "name": "senior-mobile",
-      "description": ">-",
+      "description": "Use when the user asks to \"build a mobile app\", \"scaffold React Native project\", \"create SwiftUI views\", \"set up Jetpack Compose\", \"optimize mobile performance\", \"configure Expo Router navigation\", \"implement offline-first storage\", \"submit to App Store\", or \"profile mobile rendering\". Expert mobile development covering iOS (Swift/SwiftUI), Android (Kotlin/Compose), React Native, and Flutter for native and cross-platform applications.",
       "domain": "engineering",
       "path": "engineering/senior-mobile/SKILL.md",
       "tools": [

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to the Claude Skills Library will be documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.12.2] - 2026-09-27
+
+### Fixed
+
+- **The four restored skills show their description on the site and in the catalog.** Their descriptions used the `>-` block style, which the catalog builder does not read, so `skills.json`, `registry.json` and the skill pages carried a literal `>-`. They now use the `>` style the other skills use.
+
 ## [4.12.1] - 2026-09-27 (current-Claude accuracy pass)
 
 ### Fixed

CLAUDE.md

@@ -231,7 +231,7 @@ hand-maintained `site/index.html`.
 ---
 
 **Last Updated:** September 2026
-**Version:** 4.12.1
+**Version:** 4.12.2
 **Status:** 372 skills, 68 cs-* agents (+ 8 personas), 26 commands, 21 sub-skills, 20 domains (incl. workflow meta-skills), Gemini CLI support. Engineering domain adds 4 AI-modernization skills (extended-thinking-architect, batch-api-orchestrator, computer-use-automation, agentic-evaluation-framework) + memory-tool/context-editing/reasoning-effort/caching upgrades to context-engine, llm-cost-optimizer, agent-workflow-designer, mcp-server-builder. Cross-platform surface unified — one `build_manifest.py` run regenerates `cli/skills.json`, `registry.json`, `.gemini/skills-index.json`, and the website catalog `skills.json`; all 20 domains install as Claude Code plugins; Cursor `.cursor/rules/*.mdc` added. PM domain expanded to 70 skills with career track, AI/ML PRD, activation funnels, feature flags, post-mortems, customer feedback triage, pricing PRDs, Linear/Notion/Productboard integrations, strategy frameworks (BMC/lean/SWOT/Porter's/Ansoff), and GTM (gtm-strategy/ICP).
 - **Recent additions (September 2026) — 4 skills + 2026 refresh:** marketing `ai-content-disclosure` and `conversational-ads`; PM `discovery/ai-prototyping` and `execution/agents-in-the-team` (8 stdlib tools). Existing marketing and PM skills refreshed against 2025–2026 changes: retired FAQ/HowTo rich results, AI crawler and Search Console AI controls, Advantage+/AI Max, GA4 AI Assistant channel, Productboard API v2, Jira `/search/jql`, Notion data sources, DORA 2024 benchmarks, EU AI Act Omnibus (Reg. 2026/1744), Atlassian Data Center end-of-life. Workflow templates hardened against shell injection (CWE-78).
 - **Recent additions (July 2026) — 25 skills, 3 new domains:** `business-operations/` (capacity-planner, process-mapper, vendor-management, internal-comms, knowledge-ops, procurement-optimizer), `research-ops/` (market-research, product-research, clinical-research, research-finance — applied/operational, distinct from academic `research/`), and `markdown-html/` (md-document, md-slides, md-review, design-system — stdlib-only markdown→HTML with zero network calls). Plus 5 engineering skills (write-a-skill, spec-driven-workflow, code-tour, agent-harness, cloud-security), data-analytics/statistical-analyst, 2 PM skills (team-communications, meeting-analyzer), and 3 personal-productivity skills (capture, deep-work, reflect). 44 new stdlib Python tools. Several tools ship deliberate CI gates that exit non-zero on flawed sample data — see each SKILL.md's exit-code contract.

cli/skills.json

@@ -1,6 +1,6 @@
 {
   "schema_version": "1.0.0",
-  "generated_at": "2026-09-27T19:17:42+00:00",
+  "generated_at": "2026-09-27T19:19:03+00:00",
   "skill_count": 372,
   "domain_count": 20,
   "skills": [
@@ -552,7 +552,7 @@
     {
       "name": "claude-code-mastery",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"optimize CLAUDE.md\", \"create a new skill\", \"write a custom agent\", \"configure hooks\", \"manage context window\", \"set up MCP servers\", \"scaffold a skill package\", \"analyze token budget\", \"create subagents\", \"configure permissions\", \"set up worktrees\", or \"integrate Claude Code with editors\". Covers Claude Code CLI mastery, skill authoring, context engineering, hooks automation, subagent creation, and development workflow optimization.",
       "tags": [
         "claude-code",
         "skill-authoring",
@@ -580,7 +580,7 @@
         "scripts/context_analyzer.py",
         "scripts/skill_scaffolder.py"
       ],
-      "size_bytes": 130993,
+      "size_bytes": 130992,
       "tools_count": 3,
       "has_scripts": true,
       "has_references": true,
@@ -2203,7 +2203,7 @@
     {
       "name": "senior-cloud-architect",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"design cloud architecture\", \"set up Terraform infrastructure\", \"optimize cloud costs\", \"plan disaster recovery\", \"configure multi-region failover\", \"audit IAM policies\", \"migrate to cloud\", \"set up VPC networking\", \"compare AWS vs GCP vs Azure\", or \"right-size cloud instances\". Expert cloud architecture covering AWS, GCP, Azure, multi-cloud strategy, cost optimization, security, and infrastructure automation.",
       "tags": [
         "cloud",
         "aws",
@@ -2225,7 +2225,7 @@
         "references/cloud-architecture-playbooks.md",
         "references/cloud-operations.md"
       ],
-      "size_bytes": 14721,
+      "size_bytes": 14720,
       "tools_count": 0,
       "has_scripts": false,
       "has_references": true,
@@ -2304,7 +2304,7 @@
     {
       "name": "senior-data-scientist",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"design an experiment\", \"build a predictive model\", \"run A/B test analysis\", \"perform causal inference\", \"engineer features\", \"evaluate model performance\", \"set up MLOps pipeline\", \"analyze time series\", \"calculate sample size\", or \"deploy a model to production\". Expert data science covering statistical modeling, experimentation, causal inference, feature engineering, ML deployment, and advanced analytics with Python, R, and SQL.",
       "tags": [
         "data-science",
         "ml",
@@ -2331,7 +2331,7 @@
         "scripts/feature_engineering_pipeline.py",
         "scripts/model_evaluation_suite.py"
       ],
-      "size_bytes": 32553,
+      "size_bytes": 32552,
       "tools_count": 3,
       "has_scripts": true,
       "has_references": true,
@@ -2478,7 +2478,7 @@
     {
       "name": "senior-mobile",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"build a mobile app\", \"scaffold React Native project\", \"create SwiftUI views\", \"set up Jetpack Compose\", \"optimize mobile performance\", \"configure Expo Router navigation\", \"implement offline-first storage\", \"submit to App Store\", or \"profile mobile rendering\". Expert mobile development covering iOS (Swift/SwiftUI), Android (Kotlin/Compose), React Native, and Flutter for native and cross-platform applications.",
       "tags": [
         "mobile",
         "ios",
@@ -2508,7 +2508,7 @@
         "scripts/mobile_scaffold.py",
         "scripts/store_metadata_generator.py"
       ],
-      "size_bytes": 197539,
+      "size_bytes": 197538,
       "tools_count": 3,
       "has_scripts": true,
       "has_references": true,
@@ -3014,10 +3014,11 @@
       "path": "engineering/threat-detection",
       "files": [
         "SKILL.md",
+        "examples/access.log",
         "references/threat-indicators.md",
         "scripts/threat_signal_analyzer.py"
       ],
-      "size_bytes": 25347,
+      "size_bytes": 32948,
       "tools_count": 1,
       "has_scripts": true,
       "has_references": true,

docs/INSTALLATION.md

@@ -963,5 +963,5 @@ See `.codex/skills-index.json` for the complete manifest with descriptions.
 ---
 
 **Last Updated:** September 2026
-**Skills Version:** 4.12.1 (372 production skills, 867 Python tools, 76 agents, 26 slash commands, 21 compound sub-skills, 8 CI/CD workflows)
+**Skills Version:** 4.12.2 (372 production skills, 867 Python tools, 76 agents, 26 slash commands, 21 compound sub-skills, 8 CI/CD workflows)
 **Universal Installer:** [Agent Skills CLI](https://github.com/Karanjot786/agent-skills-cli)

docs/changelog.md

@@ -8,7 +8,9 @@ For the complete version history and release notes, see [CHANGELOG.md](https://g
 
 ## Current Version
 
-**v4.12.1** (September 2026)
+**v4.12.2** (September 2026)
+
+- The four restored skills show their real description on the site and in the catalog
 
 - Current-Claude accuracy pass: four skill descriptions restored, the real Claude Code subagent format in `claude-code-mastery`, current model IDs and prices in every example and cost tool
 

documentation/WORKFLOW.md

@@ -127,8 +127,8 @@ There is no `dev → main` release PR. A release is simply an annotated tag on `
 
 ```bash
 git checkout main && git pull origin main
-git tag -a v4.12.1 -m "v4.12.1 — <summary>"
-git push origin v4.12.1
+git tag -a v4.12.2 -m "v4.12.2 — <summary>"
+git push origin v4.12.2
 ```
 
 (`cli-v*` tags trigger the npm publish workflow; `vX.Y.Z` tags do not.)

engineering/claude-code-mastery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: claude-code-mastery
-description: >-
+description: >
   Use when the user asks to "optimize CLAUDE.md", "create a new skill",
   "write a custom agent", "configure hooks", "manage context window",
   "set up MCP servers", "scaffold a skill package", "analyze token budget",

engineering/senior-cloud-architect/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: senior-cloud-architect
-description: >-
+description: >
   Use when the user asks to "design cloud architecture", "set up Terraform infrastructure",
   "optimize cloud costs", "plan disaster recovery", "configure multi-region failover",
   "audit IAM policies", "migrate to cloud", "set up VPC networking",

engineering/senior-data-scientist/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: senior-data-scientist
-description: >-
+description: >
   Use when the user asks to "design an experiment", "build a predictive model",
   "run A/B test analysis", "perform causal inference", "engineer features",
   "evaluate model performance", "set up MLOps pipeline", "analyze time series",

engineering/senior-mobile/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: senior-mobile
-description: >-
+description: >
   Use when the user asks to "build a mobile app", "scaffold React Native project",
   "create SwiftUI views", "set up Jetpack Compose", "optimize mobile performance",
   "configure Expo Router navigation", "implement offline-first storage",

registry.json

@@ -1,6 +1,6 @@
 {
   "schema_version": "1.0.0",
-  "generated_at": "2026-09-27T19:17:42+00:00",
+  "generated_at": "2026-09-27T19:19:03+00:00",
   "repository": "claude-skills",
   "skill_count": 372,
   "domain_count": 20,
@@ -282,7 +282,7 @@
     {
       "name": "claude-code-mastery",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"optimize CLAUDE.md\", \"create a new skill\", \"write a custom agent\", \"configure hooks\", \"manage context window\", \"set up MCP servers\", \"scaffold a skill package\", \"analyze token budget\", \"create subagents\", \"configure permissions\", \"set up worktrees\", or \"integrate Claude Code with editors\". Covers Claude Code CLI mastery, skill authoring, context engineering, hooks automation, subagent creation, and development workflow optimization.",
       "tags": [
         "claude-code",
         "skill-authoring",
@@ -1009,7 +1009,7 @@
     {
       "name": "senior-cloud-architect",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"design cloud architecture\", \"set up Terraform infrastructure\", \"optimize cloud costs\", \"plan disaster recovery\", \"configure multi-region failover\", \"audit IAM policies\", \"migrate to cloud\", \"set up VPC networking\", \"compare AWS vs GCP vs Azure\", or \"right-size cloud instances\". Expert cloud architecture covering AWS, GCP, Azure, multi-cloud strategy, cost optimization, security, and infrastructure automation.",
       "tags": [
         "cloud",
         "aws",
@@ -1061,7 +1061,7 @@
     {
       "name": "senior-data-scientist",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"design an experiment\", \"build a predictive model\", \"run A/B test analysis\", \"perform causal inference\", \"engineer features\", \"evaluate model performance\", \"set up MLOps pipeline\", \"analyze time series\", \"calculate sample size\", or \"deploy a model to production\". Expert data science covering statistical modeling, experimentation, causal inference, feature engineering, ML deployment, and advanced analytics with Python, R, and SQL.",
       "tags": [
         "data-science",
         "ml",
@@ -1146,7 +1146,7 @@
     {
       "name": "senior-mobile",
       "domain": "engineering",
-      "description": ">-",
+      "description": "Use when the user asks to \"build a mobile app\", \"scaffold React Native project\", \"create SwiftUI views\", \"set up Jetpack Compose\", \"optimize mobile performance\", \"configure Expo Router navigation\", \"implement offline-first storage\", \"submit to App Store\", or \"profile mobile rendering\". Expert mobile development covering iOS (Swift/SwiftUI), Android (Kotlin/Compose), React Native, and Flutter for native and cross-platform applications.",
       "tags": [
         "mobile",
         "ios",

site/INSTALLATION/index.html

@@ -3645,7 +3645,7 @@ <h2 id="support">Support<a class="headerlink" href="#support" title="Permanent l
 - Blog: https://medium.com/@borghei</p>
 <hr />
 <p><strong>Last Updated:</strong> September 2026
-<strong>Skills Version:</strong> 4.12.1 (372 production skills, 867 Python tools, 76 agents, 26 slash commands, 21 compound sub-skills, 8 CI/CD workflows)
+<strong>Skills Version:</strong> 4.12.2 (372 production skills, 867 Python tools, 76 agents, 26 slash commands, 21 compound sub-skills, 8 CI/CD workflows)
 <strong>Universal Installer:</strong> <a href="https://github.com/Karanjot786/agent-skills-cli">Agent Skills CLI</a></p>
 
 

site/changelog/index.html

@@ -1957,9 +1957,12 @@
 <h1 id="changelog">Changelog<a class="headerlink" href="#changelog" title="Permanent link">&para;</a></h1>
 <p>For the complete version history and release notes, see <a href="https://github.com/borghei/Claude-Skills/blob/main/CHANGELOG.md">CHANGELOG.md</a> in the repository.</p>
 <h2 id="current-version">Current Version<a class="headerlink" href="#current-version" title="Permanent link">&para;</a></h2>
-<p><strong>v4.12.1</strong> (September 2026)</p>
+<p><strong>v4.12.2</strong> (September 2026)</p>
 <ul>
 <li>
+<p>The four restored skills show their real description on the site and in the catalog</p>
+</li>
+<li>
 <p>Current-Claude accuracy pass: four skill descriptions restored, the real Claude Code subagent format in <code>claude-code-mastery</code>, current model IDs and prices in every example and cost tool</p>
 </li>
 <li>