> 000-jeremy-content-consistency-validator
Validates messaging consistency across website, GitHub repositories, and local documentation. Generates comprehensive read-only discrepancy reports showing where messaging conflicts or inconsistencies exist. Activates when user mentions "consistency check", "validate documentation", "check for mixed messaging", "audit content consistency", or before updating internal paperwork.
curl "https://skillshub.wtf/jeremylongshore/claude-code-plugins-plus-skills/000-jeremy-content-consistency-validator?format=md"CRITICAL OPERATING PARAMETERS:
- Temperature: 0.0 - ZERO creativity. Pure factual analysis only.
- Read-only - Report discrepancies, never suggest creative fixes
- Exact matching - Report differences precisely as found
- No interpretation - Facts only, no opinions
WORKFLOW MANDATE:
- Website = OFFICIAL source of truth
- Local docs (SOPs, standards, principles, beliefs) MUST match website
- Report what internal docs are missing compared to published website
What This Skill Does
This skill performs comprehensive read-only validation of messaging consistency across three critical content sources:
- Website Content (ANY HTML site: WordPress, Hugo, Astro, Next.js, static HTML, etc.) - OFFICIAL SOURCE OF TRUTH
- GitHub Repositories (README files, technical documentation)
- Local Documentation (SOPs, standards, principles, beliefs, training materials, internal docs, procedures)
CRITICAL: This skill NEVER makes changes. It only generates detailed discrepancy reports for human review.
When This Skill Activates
Trigger this skill when you mention:
- "Check consistency between website and GitHub"
- "Validate documentation consistency"
- "Audit messaging across platforms"
- "Find mixed messaging"
- "Before I update internal docs, check website first"
- "Ensure website matches GitHub"
- "Generate consistency report"
How It Works
Phase 1: Source Discovery
-
Identify Website Sources
- Detect and analyze ANY HTML-based website:
- Static HTML sites (index.html, about.html)
- Hugo/Astro static site generators
- Jekyll/GitHub Pages sites
- WordPress sites (wp-content/)
- Next.js/React sites (build/, out/, .next/)
- Vue/Nuxt sites (dist/, .nuxt/)
- Gatsby sites (public/)
- 11ty/Eleventy sites (_site/)
- Docusaurus sites (build/)
- Any other HTML-based website structure
- Find marketing pages, landing pages, product descriptions
- Extract key messaging: taglines, value propositions, feature lists
- Detect and analyze ANY HTML-based website:
-
Identify GitHub Sources
- Locate relevant repositories
- Find README.md, CONTRIBUTING.md, documentation folders
- Extract: project descriptions, feature claims, installation instructions
-
Identify Local Documentation
- Find internal docs, training materials, SOPs
- Locate claudes-docs/, docs/, internal/ directories
- Extract: procedures, guidelines, technical specifications
Phase 2: Content Extraction
For each source, extract:
- Core messaging (mission statements, value propositions)
- Feature descriptions (what the product/service does)
- Version numbers (software versions, release dates)
- URLs and links (external references, documentation links)
- Contact information (emails, support channels)
- Technical specifications (requirements, dependencies)
- Terminology (consistent use of product names, technical terms)
Phase 3: Consistency Analysis
Compare content across sources and identify:
š“ Critical Discrepancies:
- Conflicting version numbers
- Different feature lists
- Contradictory technical requirements
- Mismatched contact information
- Broken cross-references
š” Warning-Level Issues:
- Inconsistent terminology (e.g., "plugin" vs "extension")
- Different phrasing of same concept
- Missing information in one source
- Outdated timestamps or dates
š¢ Informational Notes:
- Stylistic differences (acceptable)
- Platform-specific variations (expected)
- Different levels of detail (appropriate)
Phase 4: Generate Discrepancy Report
Create a comprehensive Markdown report with:
# Content Consistency Validation Report
Generated: [timestamp]
## Executive Summary
- Total sources analyzed: X
- Critical discrepancies: X
- Warnings: X
- Informational notes: X
## 1. Website vs GitHub Discrepancies
### š“ CRITICAL: Version Mismatch
**Website says:** v1.2.0
**GitHub says:** v1.2.1
**Location:**
- Website: /about/index.html:45
- GitHub: README.md:12
**Recommendation:** Update website to reflect v1.2.1
### š” WARNING: Feature Description Inconsistency
**Website says:** "Supports 236 plugins"
**GitHub says:** "Over 230 plugins available"
**Impact:** Potential customer confusion
**Recommendation:** Standardize on exact number
## 2. Website vs Local Docs Discrepancies
### š“ CRITICAL: Contact Email Mismatch
**Website says:** support@example.com
**Local docs say:** help@example.com
**Training materials:** Support email is support@example.com
**Recommendation:** Update local docs to support@example.com
## 3. GitHub vs Local Docs Discrepancies
### š” WARNING: Installation Instructions Differ
**GitHub:** "Run npm install"
**Local docs:** "Use pnpm install"
**Impact:** Training may teach wrong commands
**Recommendation:** Synchronize to pnpm install
## 4. Terminology Consistency Issues
| Term Used | Website | GitHub | Local Docs | Recommendation |
|-----------|---------|--------|------------|----------------|
| Plugin/Extension | Plugin | Extension | Plugin | Standardize on "Plugin" |
| Marketplace/Repository | Marketplace | Repository | Marketplace | Standardize on "Marketplace" |
## 5. Action Items (Priority Order)
1. š“ Update website version to v1.2.1
2. š“ Fix contact email in local docs
3. š” Standardize plugin count messaging
4. š” Align installation instructions
5. š¢ Standardize terminology usage
Validation Workflow Example
User: "Before I update my internal training materials, check if my website matches GitHub"
Skill Actions:
- Scans website for core messaging, features, version
- Scans GitHub README, docs for same information
- Extracts current training materials content
- Compares all three sources
- Generates detailed discrepancy report
- Highlights critical issues that must be fixed first
- Provides specific file locations and line numbers
Output: Comprehensive report showing exactly what's inconsistent and where to fix it
Best Practices
Source Priority (Use This When Conflicts Exist)
Trust Priority Order:
- Website - Public-facing, most authoritative
- GitHub - Developer-facing, technical accuracy
- Local Docs - Internal-use, lowest priority for public messaging
Update Flow: Website ā GitHub ā Local Docs
When to Run Validation
ā Run validation BEFORE:
- Updating internal documentation
- Creating training materials
- Writing new marketing content
- Publishing blog posts
- Releasing new versions
ā Run validation AFTER:
- Website updates
- GitHub README changes
- Major feature releases
- Rebranding efforts
What This Skill Does NOT Do
ā Does NOT automatically fix issues ā Does NOT modify any files ā Does NOT make content decisions ā Does NOT prioritize which version is "correct" ā ONLY generates read-only reports for human review
Integration with Your Workflow
Scenario: Pre-Update Validation
You: "I need to update our internal SOPs. First, validate consistency with the website."
Skill Response:
- Reads current website content
- Reads current GitHub documentation
- Reads existing internal SOPs
- Generates comparison report
- Shows you exactly what needs updating in SOPs
- Identifies messaging that website uses but SOPs don't
Result: You update SOPs with confidence, knowing they match public messaging
Scenario: Post-Website Update
You: "I just updated the website pricing page. Check if GitHub and docs are now inconsistent."
Skill Response:
- Reads NEW website pricing information
- Compares to GitHub repository pricing docs
- Compares to internal sales training materials
- Flags any discrepancies created by website update
- Provides checklist of what to update next
Result: Prevents mixed messaging cascade
Technical Implementation
Read-Only Tools Used
Read- Reads local files (website, docs, SOPs)Glob- Finds relevant files by patternGrep- Searches for specific terms across filesWebFetch- Reads deployed website pages (if needed)Bash(read-only) - Usescat,grep,findfor analysis
NO Write Operations
This skill NEVER uses:
- ā
Writetool - ā
Edittool - ā
git commitcommands - ā File modification operations
Output Format
- Markdown report saved to
consistency-reports/YYYY-MM-DD-HH-MM-SS.md - Terminal-friendly summary
- Export to JSON for automation (optional)
Example Use Cases
Use Case 1: Version Consistency Check
Trigger: "Check if all docs mention the same version number"
Result:
Version Analysis Report
Website: v1.2.1 (5 mentions)
GitHub: v1.2.1 (3 mentions), v1.2.0 (2 mentions) ā ļø
Local Docs: v1.2.0 (8 mentions) š“
Action: Update Local Docs to v1.2.1
Use Case 2: Feature Claim Validation
Trigger: "Validate that all platforms claim the same features"
Result:
Feature Consistency Analysis
"236 plugins": Website ā
, GitHub ā
, Docs ā (says "230+")
"Agent Skills": Website ā
, GitHub ā
, Docs ā
"MCP Support": Website ā
, GitHub ā
, Docs ā ļø (unclear mention)
Action: Update Docs to specify "236 plugins" and clarify MCP support
Use Case 3: Pre-Training Update
Trigger: "Before I update training materials, what's changed on the website?"
Result:
Website Changes Since Last Training Update (Oct 15)
- New feature added: "Skill Enhancers" (not in training)
- Pricing updated: $39/mo ā $49/mo (not in training)
- Contact form URL changed (broken link in training)
Suggested Training Updates:
1. Add Skill Enhancers section
2. Update pricing screenshots
3. Fix contact form URL
Integration Points
Works seamlessly with:
- All HTML-based websites: Static HTML, Hugo, Astro, Jekyll, WordPress, Next.js, React, Vue, Nuxt, Gatsby, 11ty, Docusaurus, and more
- GitHub repositories: README files, documentation, code comments
- Local markdown documentation: Internal docs, training materials
- Internal wikis and knowledge bases: Confluence, Notion exports, custom wikis
- Content management systems: WordPress, Drupal, custom CMS
- Static site generators: Hugo, Jekyll, 11ty, Gatsby, Astro, Docusaurus
- Modern web frameworks: Next.js, Nuxt, SvelteKit build outputs
Report Storage
Reports saved to:
consistency-reports/
āāā 2025-10-23-10-30-45-full-audit.md
āāā 2025-10-22-15-20-12-website-github.md
āāā 2025-10-20-09-15-33-docs-sync.md
Expected Activation Patterns
Natural Language Triggers:
- "Check consistency"
- "Validate documentation"
- "Audit messaging"
- "Find discrepancies"
- "Compare website to GitHub"
- "Before I update X, check Y"
- "What's out of sync?"
Context-Aware Activation:
- When user is about to update documentation
- When user asks about version consistency
- When user mentions "mixed messaging"
- When user is preparing training materials
> related_skills --same-repo
> agent-context-loader
PROACTIVE AUTO-LOADING: Automatically detects and loads AGENTS.md files from the current working directory when starting a session or changing directories. This skill ensures agent-specific instructions are incorporated into Claude Code's context alongside CLAUDE.md, enabling specialized agent behaviors. Triggers automatically when Claude detects it's working in a directory, when starting a new session, or when explicitly requested to "load agent context" or "check for AGENTS.md file".
> Google Cloud Agent SDK Master
Automatic activation for ALL Google Cloud Agent Development Kit (ADK) and Agent Starter Pack operations - multi-agent systems, containerized deployment, RAG agents, and production orchestration. **TRIGGER PHRASES:** - "adk", "agent development kit", "agent starter pack", "multi-agent", "build agent" - "cloud run agent", "gke deployment", "agent engine", "containerized agent" - "rag agent", "react agent", "agent orchestration", "agent templates" **AUTO-INVOKES FOR:** - Agent creation and scaffold
> Vertex AI Media Master
Automatic activation for ALL Google Vertex AI multimodal operations - video processing, audio generation, image creation, and marketing campaigns. **TRIGGER PHRASES:** - "vertex ai", "gemini multimodal", "process video", "generate audio", "create images", "marketing campaign" - "imagen", "video understanding", "multimodal", "content generation", "media assets" **AUTO-INVOKES FOR:** - Video processing and understanding (up to 6 hours) - Audio generation and transcription - Image generation with I
> yaml-master
PROACTIVE YAML INTELLIGENCE: Automatically activates when working with YAML files, configuration management, CI/CD pipelines, Kubernetes manifests, Docker Compose, or any YAML-based workflows. Provides intelligent validation, schema inference, linting, format conversion (JSON/TOML/XML), and structural transformations with deep understanding of YAML specifications and common anti-patterns.