flitzrrr/agent-skills / skills/product-description-seo
product-description-seo
VerifiedEnd-to-end skill for SEO-optimized product descriptions: inventory analysis, generation, quality assurance, catalog update, and deployment. Use whenever the user wants to analyze, write, check, update, or deploy product descriptions — whether for a single product, a category, or an entire catalog. Triggers on: 'product description', 'Produktbeschreibung', 'SEO text', 'catalog text', 'update descriptions', 'which descriptions are missing', 'thin content', 'QA check', 'description quality', or when the user names a product category and wants texts for it. Also triggers on 'deploy' or 'commit' in the context of product descriptions.
| File | Kind | Size |
|---|---|---|
| CROSS-SELL.md | markdown | 1.9 KB |
| KEYWORDS.md | markdown | 1.3 KB |
| SKILL.md | skill md | 12.5 KB |
| scripts/analyze_catalog.py | script | 4.8 KB |
| scripts/check_quality.py | script | 7.5 KB |
| scripts/extract_category.py | script | 2.9 KB |
| scripts/track_progress.py | script | 5.0 KB |
| scripts/update_catalog.py | script | 2.3 KB |
| scripts/validate_json.py | script | 2.5 KB |
scripts/validate_json.py
View on GitHub#!/usr/bin/env python3
"""Validate catalog JSON structure after description updates.
Usage:
python validate_json.py <catalog.json>
Checks: valid JSON, required fields, no duplicate SKUs,
no HTML in descriptions, valid slug format.
"""
import json
import sys
import re
from collections import Counter
REQUIRED_FIELDS = ["sku", "name", "slug"]
def main():
if len(sys.argv) < 2:
print("Usage: python validate_json.py <catalog.json>")
sys.exit(1)
path = sys.argv[1]
errors = []
warnings = []
try:
with open(path, "r", encoding="utf-8") as f:
data = json.load(f)
except json.JSONDecodeError as e:
print(f"[-] FATAL: Invalid JSON: {e}")
sys.exit(1)
products = data.get("products", [])
print(f"Validating {len(products)} products in {path}...")
# Required fields
for i, p in enumerate(products):
for field in REQUIRED_FIELDS:
if field not in p:
errors.append(f"Product #{i} (SKU {p.get('sku', '?')}): missing field '{field}'")
# Duplicate SKUs
skus = [p.get("sku", "") for p in products]
dupes = [sku for sku, count in Counter(skus).items() if count > 1]
if dupes:
errors.append(f"Duplicate SKUs: {', '.join(dupes)}")
# Empty descriptions
desc_field = "beschreibung" if any("beschreibung" in p for p in products[:5]) else "description"
for p in products:
if not p.get(desc_field, "").strip():
warnings.append(f"SKU {p.get('sku', '?')}: empty description")
# HTML in descriptions
for p in products:
desc = p.get(desc_field, "")
if re.search(r'<[^>]+>', desc):
errors.append(f"SKU {p.get('sku', '?')}: HTML tags found in description")
# Slug format
for p in products:
slug = p.get("slug", "")
if slug and not re.match(r'^[a-z0-9\-_\.]+$', slug):
warnings.append(f"SKU {p.get('sku', '?')}: slug '{slug}' contains invalid characters")
# Report
print(f"\n{'=' * 50}")
if errors:
print(f"[-] {len(errors)} errors found:")
for e in errors:
print(f" [-] {e}")
if warnings:
print(f"[!] {len(warnings)} warnings:")
for w in warnings:
print(f" [!] {w}")
if not errors and not warnings:
print("[+] All validations passed!")
elif not errors:
print(f"\n[+] No critical errors. {len(warnings)} warnings.")
sys.exit(1 if errors else 0)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |