Files
our-claude-skills/ourdigital-custom-skills/14-seo-schema-generator/code/CLAUDE.md
Andrew Yim eea49f9f8c refactor(skills): Restructure skills to dual-platform architecture
Major refactoring of ourdigital-custom-skills with new numbering system:

## Structure Changes
- Each skill now has code/ (Claude Code) and desktop/ (Claude Desktop) versions
- New progressive numbering: 01-09 General, 10-19 SEO, 20-29 GTM, 30-39 OurDigital, 40-49 Jamie

## Skill Reorganization
- 01-notion-organizer (from 02)
- 10-18: SEO tools split into focused skills (technical, on-page, local, schema, vitals, gsc, gateway)
- 20-21: GTM audit and manager
- 30-32: OurDigital designer, research, presentation
- 40-41: Jamie brand editor and audit

## New Files
- .claude/commands/: Slash command definitions for all skills
- CLAUDE.md: Updated with new skill structure documentation
- REFACTORING_PLAN.md: Migration documentation
- COMPATIBILITY_REPORT.md, SKILLS_COMPARISON.md: Analysis docs

## Removed
- Old skill directories (02-05, 10-14, 20-21 old numbering)
- Consolidated into new structure with _archive/ for reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 01:58:24 +09:00

2.6 KiB

CLAUDE.md

Overview

Schema markup generator: create JSON-LD structured data from templates for various content types.

Quick Start

pip install -r scripts/requirements.txt

# Generate Organization schema
python scripts/schema_generator.py --type organization --url https://example.com

# Generate from template
python scripts/schema_generator.py --template templates/article.json --data article_data.json

Scripts

Script Purpose
schema_generator.py Generate schema markup
base_client.py Shared utilities

Supported Schema Types

Type Template Use Case
Organization organization.json Company/brand info
LocalBusiness local_business.json Physical locations
Article article.json Blog posts, news
Product product.json E-commerce items
FAQPage faq.json FAQ sections
BreadcrumbList breadcrumb.json Navigation path
WebSite website.json Site-level info

Usage Examples

Organization

python scripts/schema_generator.py --type organization \
  --name "Company Name" \
  --url "https://example.com" \
  --logo "https://example.com/logo.png"

LocalBusiness

python scripts/schema_generator.py --type localbusiness \
  --name "Restaurant Name" \
  --address "123 Main St, City, State 12345" \
  --phone "+1-555-123-4567" \
  --hours "Mo-Fr 09:00-17:00"

Article

python scripts/schema_generator.py --type article \
  --headline "Article Title" \
  --author "Author Name" \
  --published "2024-01-15" \
  --image "https://example.com/image.jpg"

FAQPage

python scripts/schema_generator.py --type faq \
  --questions questions.json

Output

Generated JSON-LD ready for insertion:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Company Name",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png"
}
</script>

Template Customization

Templates in templates/ can be modified. Required fields are marked:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{{REQUIRED}}",
  "author": {
    "@type": "Person",
    "name": "{{REQUIRED}}"
  },
  "datePublished": "{{REQUIRED}}",
  "image": "{{RECOMMENDED}}"
}

Validation

Generated schemas are validated before output:

  • Syntax correctness
  • Required properties present
  • Schema.org vocabulary compliance

Use skill 13 (schema-validator) for additional validation.

Dependencies

jsonschema>=4.21.0
requests>=2.31.0
python-dotenv>=1.0.0