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:
| Command |
Description |
uv run python scripts/seo_audit.py --all |
Full SEO audit (source files) |
uv run python scripts/seo_audit.py --live |
Live site audit (deployed website) |
uv run python scripts/seo_audit.py --all --live |
Both source and live audits |
uv run python scripts/seo_audit.py --meta |
Meta tags validation only |
uv run python scripts/seo_audit.py --schema |
Schema.org validation only |
uv run python scripts/seo_audit.py --content |
Content analysis (headings, keywords) |
uv run python scripts/seo_audit.py --technical |
Technical SEO checks |
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 validationhttpx - 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 schemasrc/content/schemas/website.json - WebSite schemasrc/utils/schemas/ - Dynamic schema generators
Configuration
nuxt.config.ts - Sitemap, runtime config, SEO settings
SEO Improvement Workflow
- Audit: Run
uv run python scripts/seo_audit.py --all to identify issues
- Review: Check reports in
scripts/output/
- Fix: Apply changes to relevant src/ files
- 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
1---2name: seo3description: SEO audit and optimization skill for Meryll Dindin's personal portfolio website. Activates when discussing meta tags, Schema.org, structured data, personal branding SEO, search optimization, or content improvements.4---5
6# SEO Skill - Helix Portfolio
7
8## Skill Structure
9
10```
11seo/
12├── SKILL.md # This file
13├── pyproject.toml # Python dependencies
14├── references/ # Context documents
15│ └── seo-guidelines.md
16└── scripts/ # Python implementation
17 ├── seo_audit.py # Main entry point
18 ├── output/ # Audit reports
19 ├── validators/ # SEO validation modules
20 └── models/ # Pydantic models
21```
22
23## Activation Triggers
24
25This skill activates automatically when discussing:
26
27- SEO, meta tags, Schema.org, structured data for the portfolio
28- Search engine optimization for personal branding
29- Professional profile SEO (LinkedIn, GitHub, social profiles)
30- Page performance, Core Web Vitals, technical SEO
31- Content optimization, keywords, heading hierarchy
32- Review and optimize pages for search traffic
33
34## Commands
35
36Run from the skill root directory:
37
38| Command | Description |
39| ------------------------------------------------- | ------------------------------------- |
40| `uv run python scripts/seo_audit.py --all` | Full SEO audit (source files) |
41| `uv run python scripts/seo_audit.py --live` | Live site audit (deployed website) |
42| `uv run python scripts/seo_audit.py --all --live` | Both source and live audits |
43| `uv run python scripts/seo_audit.py --meta` | Meta tags validation only |
44| `uv run python scripts/seo_audit.py --schema` | Schema.org validation only |
45| `uv run python scripts/seo_audit.py --content` | Content analysis (headings, keywords) |
46| `uv run python scripts/seo_audit.py --technical` | Technical SEO checks |
47
48### Live Site Validator
49
50The `--live` flag fetches and analyzes the deployed website at `https://merylldindin.com`:
51
52- Verifies robots.txt and sitemap.xml accessibility
53- Checks meta tags (title, description, canonical, OG tags)
54- Validates heading hierarchy (H1 presence)
55- Confirms SSR is rendering content server-side
56- Detects JSON-LD structured data presence
57
58## Dependencies
59
60- `pydantic` - Data validation
61- `httpx` - HTTP client for live site validation
62
63## Key Website Files
64
65### Meta Management
66
67- `src/content/pages/*.json` - Page-level content with head.\* meta
68
69### Schema.org
70
71- `src/content/schemas/default.json` - Person schema
72- `src/content/schemas/website.json` - WebSite schema
73- `src/utils/schemas/` - Dynamic schema generators
74
75### Configuration
76
77- `nuxt.config.ts` - Sitemap, runtime config, SEO settings
78
79## SEO Improvement Workflow
80
811. **Audit**: Run `uv run python scripts/seo_audit.py --all` to identify issues
822. **Review**: Check reports in `scripts/output/`
833. **Fix**: Apply changes to relevant src/ files
844. **Verify**: Re-run specific validators to confirm fixes
85
86## Quick Reference
87
88### Meta Tag Guidelines
89
90- Title: 50-60 characters, keyword-first
91- Description: 120-160 characters, compelling summary
92- Canonical: Absolute URL with trailing slash
93- OG Image: 1200x630px recommended
94
95### Schema.org Types Used
96
97- Person (primary identity)
98- WebSite / WebPage
99- Article / BlogPosting (thoughts section)
100- BreadcrumbList
101- ItemList (collections)
102
103### Priority Keywords
104
105**Primary**: Meryll Dindin, AI entrepreneur, data scientist, healthcare AI
106**Professional**: machine learning, artificial intelligence, startup founder
107**Ventures**: Polygon, Parallel Learning, Dillygence
108
109## Site Architecture
110
111```
112/ → Landing page
113/ventures/ → Companies & projects
114/thoughts/ → Blog/articles
115/suggestions/ → Recommendations
116/mentions/ → Press & media
117/missions/ → Mission statement
118```
majiayu000