Genpark Content Quality Auditor Skill

An intelligent Python auditing tool and skill module designed to evaluate product descriptions, e-commerce listings, and marketing copy for clarity, completeness, keyword density, sentence variance, and brand consistency.

Overview

The Content Quality Auditor skill provides automated quality scoring (0-100) and actionable improvement recommendations for marketing copy writers and e-commerce merchants. It analyzes copy against industry best practices to eliminate weak phrasing, verify key benefit coverage, ensure optimal word counts, and maintain engaging sentence cadence.

Capabilities & Audit Metrics

1. Word Count & Length Optimization
   • Flags content under 50 words (insufficient detail) or over 500 words (high bounce risk).
2. Target Keyword Density & Coverage
   • Calculates exact keyword coverage percentage (0.0% - 100.0%).
   • Identifies missing target keywords required for SEO/PPC landing page optimization.
3. Weak & Vague Vocabulary Detection
   • Scans for generic filler terms (good, nice, great, thing, stuff, very, really, amazing).
   • Recommends replacing weak words with specific, quantifiable product metrics.
4. Sentence Length Variance & Cadence
   • Calculates standard deviation of sentence lengths to detect monotonous sentence rhythm.
   • Flags single continuous sentence blocks for legibility improvements.
5. Brand Name Inclusion
   • Verifies explicit inclusion of the product name in the listing copy.
6. Audience Alignment Insights
   • Provides audience-aware suggestions (e.g. recommending spec-heavy terms for technical audiences).

---

Directory Structure

genpark-content-quality-auditor-skill/
├── skill.json               # Skill manifest specifying input/output schemas and prompt
├── content_quality_agent.py # Core Python agent implementation (ContentQualityClient)
├── example_usage.py         # Executable example script demonstrating audit scenarios
├── requirements.txt         # Python dependencies (Standard library only)
└── README.md                # Skill documentation and guide

---

Installation & Setup

No external Python dependencies are required; the skill runs entirely on standard Python 3.8+ libraries (re, math, json, typing).

git clone <repository_url>
cd genpark-content-quality-auditor-skill

---

Quickstart & Usage

Python API

from content_quality_agent import ContentQualityClient

# Instantiate the quality auditor client
auditor = ContentQualityClient()

# Perform copy audit
report = auditor.audit(
    content="Elevate your audio with AeroSound Pro Headphones. Features active noise cancellation and Bluetooth 5.3.",
    product_name="AeroSound Pro",
    target_audience="audio enthusiast",
    keywords=["active noise cancellation", "bluetooth 5.3", "battery life", "ergonomic fit"]
)

print("Quality Score:", report["quality_score"])
print("Keyword Coverage (%):", report["keyword_coverage_pct"])
print("Issues Found:", report["issues"])
print("Suggestions:", report["suggestions"])

Running the Example Script

Execute example_usage.py to view weak vs. strong marketing copy comparison audits:

python example_usage.py

---

Input & Output Specification

Input Schema (inputs)

• content (string, required): Product copy text to analyze.
• product_name (string, optional): Expected product name.
• target_audience (string, optional): Intended target demographic.
• keywords (array of strings, optional): List of essential target keywords.

Output Schema (outputs)

• quality_score (number, range 0 - 100): Overall content quality score.
• keyword_coverage_pct (number, range 0 - 100): Percentage of target keywords identified.
• issues (array of objects): Detected issues with type, severity (high | medium | low), and detail.
• suggestions (array of strings): Ranked, actionable improvement tips.

---

License

MIT License. Developed by alphaparkinc.