Add markdown validation and fix parsing errors across skills

  - Add scripts/validate-markdown.py for detecting markdown issues
    (HTML in tables, unclosed code blocks, missing separators, column mismatches)
  - Integrate validation into CI workflow and release checklist
  - Fix JQL syntax in epic planning workflows (Parent → "Epic Link")
  - Fix HTML comments breaking tables in code-reviewer, debugging-wizard
  - Add missing closing code fences in incident-chaos, mysql-tuning, postgresql-tuning
  - Escape pipe character in php-pro/modern-php-features.md table
  version bump v0.4.5
  Closes #138

Author: Jeffallan

.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Comprehensive skill pack for full-stack developers covering frameworks, workflows, and security",
-    "version": "0.4.4"
+    "version": "0.4.5"
   },
   "plugins": [
     {
       "name": "fullstack-dev-skills",
       "source": "./",
       "description": "65 specialized skills for full-stack development: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing skills. Includes 9 project workflow commands for epic planning, discovery, execution, and retrospectives.",
-      "version": "0.4.4",
+      "version": "0.4.5",
       "author": {
         "name": "jeffallan",
         "email": "github@jeffallan"

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fullstack-dev-skills",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Comprehensive skill pack with 65 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.",
   "author": {
         "name": "jeffallan",

.github/workflows/validate.yml

@@ -23,5 +23,8 @@ jobs:
       - name: Validate skills
         run: python scripts/validate-skills.py
 
+      - name: Validate markdown
+        run: python scripts/validate-markdown.py --check
+
       - name: Check docs in sync
         run: python scripts/update-docs.py --check

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project 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).
 
+## [0.4.5] - 2026-02-05
+
+### Added
+- Added "Mentioned in Awesome Claude Code" badge to README (closes #138)
+- Added Awesome Claude Code stat to social preview
+- Added `scripts/validate-markdown.py` for detecting markdown parsing errors
+  - Checks for HTML comments breaking tables, unclosed code blocks, missing table separators, column count mismatches
+  - Integrated into CI workflow and release checklist
+
+### Fixed
+- Fixed markdown bold formatting rendering as raw `**` in README.md (#139)
+- Fixed minor syntax error in skill YAML frontmatter (#137)
+- Fixed incorrect JQL syntax in epic planning workflows (`Parent =` → `"Epic Link" =`)
+  - Affected: `create-epic-plan`, `create-epic-discovery`, `WORKFLOW_COMMANDS.md`
+- Fixed markdown parsing errors across skill files:
+  - Moved HTML comments above tables in `code-reviewer` and `debugging-wizard` skills
+  - Added missing closing code fences in `incident-chaos`, `mysql-tuning`, `postgresql-tuning`
+  - Escaped pipe character in `php-pro/modern-php-features.md` table
+
+### Contributors
+- @hesreallyhim — Featured in Awesome Claude Code (#138)
+- @hesreallyhim — Fix formatting and links in README.md (#139)
+- @hesreallyhim — fix: minor syntax error in .md yaml frontmatter (#137)
+
 ## [0.4.4] - 2026-02-03
 
 ### Fixed
@@ -283,6 +307,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Monitoring: Prometheus, Grafana, ELK, DataDog
 - Security: OWASP Top 10, SAST tools
 
+[0.4.5]: https://github.com/jeffallan/claude-skills/compare/v0.4.4...v0.4.5
 [0.4.4]: https://github.com/jeffallan/claude-skills/compare/v0.4.3...v0.4.4
 [0.4.3]: https://github.com/jeffallan/claude-skills/compare/v0.4.2...v0.4.3
 [0.4.2]: https://github.com/jeffallan/claude-skills/compare/v0.4.1...v0.4.2

CLAUDE.md

@@ -239,7 +239,30 @@ python scripts/validate-skills.py --help             # Full usage
 
 **Exit codes:** 0 = success (warnings OK), 1 = errors found
 
-### 6. Final Verification
+### 6. Validate Markdown Syntax
+
+**Critical:** Run markdown validation to catch parsing errors.
+
+```bash
+python scripts/validate-markdown.py
+```
+
+The script validates:
+- **HTML comments in tables** - Comments between table rows break parsing
+- **Unclosed code blocks** - Ensures all code fences are properly closed
+- **Missing table separators** - Tables require `|---|` row after header
+- **Column count consistency** - All table rows must have same column count
+
+**Options:**
+```bash
+python scripts/validate-markdown.py --check       # CI mode (exit code only)
+python scripts/validate-markdown.py --path FILE   # Single file
+python scripts/validate-markdown.py --format json # JSON output for CI
+```
+
+**Exit codes:** 0 = no issues, 1 = issues found
+
+### 7. Final Verification
 
 After running validation, manually verify:
 

README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/jeffallan/claude-skills"><img src="https://img.shields.io/badge/version-0.4.4-blue.svg?style=for-the-badge" alt="Version"/></a>
+  <a href="https://github.com/jeffallan/claude-skills"><img src="https://img.shields.io/badge/version-0.4.5-blue.svg?style=for-the-badge" alt="Version"/></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge" alt="License"/></a>
   <a href="https://github.com/jeffallan/claude-skills"><img src="https://img.shields.io/badge/Claude_Code-Plugin-purple.svg?style=for-the-badge" alt="Claude Code"/></a>
   <a href="https://github.com/jeffallan/claude-skills/stargazers"><img src="https://img.shields.io/github/stars/jeffallan/claude-skills?style=for-the-badge&color=yellow" alt="Stars"/></a>
@@ -15,6 +15,7 @@
 </p>
 
 <p align="center">
+  <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" height="28" alt="Mentioned in Awesome Claude Code"/></a>
   <a href="https://github.com/Chat2AnyLLM/awesome-claude-skills/blob/main/FULL-SKILLS.md"><img src="https://img.shields.io/github/stars/Chat2AnyLLM/awesome-claude-skills?style=for-the-badge&label=awesome-claude-skills&color=brightgreen&logo=awesomelists&logoColor=white" alt="Awesome Claude Skills"/></a>
   <a href="https://github.com/BehiSecc/awesome-claude-skills"><img src="https://img.shields.io/github/stars/BehiSecc/awesome-claude-skills?style=for-the-badge&label=awesome-claude-skills&color=brightgreen&logo=awesomelists&logoColor=white" alt="Awesome Claude Skills (BehiSecc)"/></a>
 </p>

ROADMAP.md

@@ -2,7 +2,7 @@
 
 ## Current Status
 
-**Version:** v<!-- VERSION -->0.4.4<!-- /VERSION --> (Released January 2026)
+**Version:** v<!-- VERSION -->0.4.5<!-- /VERSION --> (Released January 2026)
 
 - **<!-- SKILL_COUNT -->65<!-- /SKILL_COUNT --> Skills** across 12 domains
 - **<!-- REFERENCE_COUNT -->359<!-- /REFERENCE_COUNT --> Reference Files** with progressive disclosure architecture
@@ -202,4 +202,4 @@ We welcome community input on the roadmap direction. Here's how you can contribu
 
 ---
 
-*This roadmap is a living document and subject to change based on community feedback, technical constraints, and emerging priorities. Last updated: February 2026 (v0.4.4)*
+*This roadmap is a living document and subject to change based on community feedback, technical constraints, and emerging priorities. Last updated: February 2026 (v0.4.5)*

assets/social-preview.html

@@ -92,17 +92,31 @@
             box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
         }
 
+        /* Title row */
+        .title-row {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            margin-bottom: 24px;
+        }
+
         /* Title */
         .title {
             font-size: 92px;
             font-weight: 900;
             color: #ffffff;
             line-height: 1;
-            margin-bottom: 24px;
+            margin-bottom: 0;
             letter-spacing: -0.03em;
             text-shadow: 0 2px 40px rgba(0, 0, 0, 0.3);
         }
 
+        /* Awesome badge */
+        .awesome-badge {
+            height: 56px;
+            filter: drop-shadow(0 4px 16px rgba(0, 0, 0, 0.3));
+        }
+
         /* Subtitle */
         .subtitle {
             font-size: 36px;
@@ -234,8 +248,11 @@
             <!-- Icon -->
             <!-- <div class="icon">⚡</div> -->
 
-            <!-- Title -->
-            <h1 class="title">Claude Skills</h1>
+            <!-- Title row with badge -->
+            <div class="title-row">
+                <h1 class="title">Claude Skills</h1>
+                <img src="https://awesome.re/mentioned-badge.svg" class="awesome-badge" alt="Mentioned in Awesome Claude Code"/>
+            </div>
 
             <!-- Subtitle -->
             <h2 class="subtitle"><!-- SKILL_COUNT -->65<!-- /SKILL_COUNT --> Specialized Skills and <!-- WORKFLOW_COUNT -->9<!-- /WORKFLOW_COUNT --> workflows for Full-Stack Developers</h2>

assets/social-preview.png

@@ -76,7 +76,7 @@ Creates tickets in target implementation epics
 ## Phase 1: Question Extraction
 
 1. **Read all Jira tickets** linked to epic `{Epic_Key}`
-   - Use JQL query: `Parent = {Epic_Key}` to find all child tickets
+   - Use JQL query: `"Epic Link" = {Epic_Key}` to find all child tickets
    - Extract acceptance criteria from each ticket
    - Identify ticket dependencies and relationships
    - Note any technical constraints mentioned