SEO Skill - Helix Portfolio

Skill Structure

seo/
├── SKILL.md              # This file
├── pyproject.toml        # Python dependencies
├── references/           # Context documents
│   └── seo-guidelines.md
└── scripts/              # Python implementation
    ├── seo_audit.py      # Main entry point
    ├── output/           # Audit reports
    ├── validators/       # SEO validation modules
    └── models/           # Pydantic models

Activation Triggers

This skill activates automatically when discussing:

• SEO, meta tags, Schema.org, structured data for the portfolio
• Search engine optimization for personal branding
• Professional profile SEO (LinkedIn, GitHub, social profiles)
• Page performance, Core Web Vitals, technical SEO
• Content optimization, keywords, heading hierarchy
• Review and optimize pages for search traffic

Commands

Run from the skill root directory:

Live Site Validator

The --live flag fetches and analyzes the deployed website at https://merylldindin.com:

• Verifies robots.txt and sitemap.xml accessibility
• Checks meta tags (title, description, canonical, OG tags)
• Validates heading hierarchy (H1 presence)
• Confirms SSR is rendering content server-side
• Detects JSON-LD structured data presence

Dependencies

• pydantic - Data validation
• httpx - HTTP client for live site validation

Key Website Files

Meta Management

• src/content/pages/*.json - Page-level content with head.* meta

Schema.org

• src/content/schemas/default.json - Person schema
• src/content/schemas/website.json - WebSite schema
• src/utils/schemas/ - Dynamic schema generators

Configuration

• nuxt.config.ts - Sitemap, runtime config, SEO settings

SEO Improvement Workflow

1. Audit: Run uv run python scripts/seo_audit.py --all to identify issues
2. Review: Check reports in scripts/output/
3. Fix: Apply changes to relevant src/ files
4. Verify: Re-run specific validators to confirm fixes

Quick Reference

Meta Tag Guidelines

• Title: 50-60 characters, keyword-first
• Description: 120-160 characters, compelling summary
• Canonical: Absolute URL with trailing slash
• OG Image: 1200x630px recommended

Schema.org Types Used

• Person (primary identity)
• WebSite / WebPage
• Article / BlogPosting (thoughts section)
• BreadcrumbList
• ItemList (collections)

Priority Keywords

Primary: Meryll Dindin, AI entrepreneur, data scientist, healthcare AI Professional: machine learning, artificial intelligence, startup founder Ventures: Polygon, Parallel Learning, Dillygence

Site Architecture

/                          → Landing page
/ventures/                 → Companies & projects
/thoughts/                 → Blog/articles
/suggestions/              → Recommendations
/mentions/                 → Press & media
/missions/                 → Mission statement