skills/content-seo-agent/SKILL.md
AI content and SEO agent that audits sites, fixes indexing issues, writes blog posts aligned with OKRs, generates YouTube metadata, and produces monthly analytics reports. Use when asked to run SEO audit, write a blog post, create content calendar, fix indexing, generate YouTube descriptions, or produce an analytics report.
npx skillsauth add razbakov/skills content-seo-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
AI agent that performs the work of a Content & SEO Marketer across the portfolio. Operates on 5 projects: DanceGods (SEO), razbakov.com (blog), web100 (lead gen content), ai-study-group (YouTube), SMM Manager (social distribution).
Reference: ikigai/hiring/content-seo-marketer.md
When: "run SEO audit on [project]" or monthly check
Process:
nuxt.config.ts to check SEO modules (sitemap, robots, schema-org)# Check sitemap exists and is valid
curl -s https://[domain]/sitemap.xml | head -50
# Check robots.txt
curl -s https://[domain]/robots.txt
# Check meta tags on key pages
curl -s https://[domain]/ | grep -i '<meta'
.vue files in pages/ for useHead() or useSeoMeta() calls.md files in content/ for frontmatter (title, description, image)Output template — save to [project]/reports/seo-audit-YYYY-MM-DD.md:
# SEO Audit — [Project] — YYYY-MM-DD
## Summary
- Pages audited: N
- Issues found: N (critical: N, warning: N, info: N)
## Critical Issues
- [ ] [description] — [file:line] — [fix]
## Warnings
- [ ] [description] — [file:line] — [fix]
## Technical Checks
| Check | Status | Notes |
|-------|--------|-------|
| sitemap.xml | OK/FAIL | |
| robots.txt | OK/FAIL | |
| Schema.org | OK/FAIL | |
| OG tags | OK/FAIL | |
| Canonical URLs | OK/FAIL | |
| Trailing slashes | OK/FAIL | |
## Recommendations
1. [prioritized fix]
When: "write a blog post about [topic]"
Process:
ikigai/README.md to ensure alignmentrazbakov.com/content/blog/ to avoid duplication and match styleTemplate — save to razbakov.com/content/blog/YYYY-MM-DD-[slug].md:
---
title: "[Title — under 60 chars for SEO]"
description: "[Meta description — 150-160 chars, includes primary keyword]"
date: YYYY-MM-DD
image: /blog/[slug]/cover.png
tags: [relevant, tags]
lang: en
---
[Content — 800-1500 words, scannable with headers, practical value]
lang: deWhen: "create content calendar" or start of month
Process:
ikigai/README.mdikigai/sessions/ for content ideasikigai/marketing/ for brand voice guidelinesOutput template — save to ikigai/marketing/content-calendar-YYYY-MM.md:
# Content Calendar — YYYY-MM
## Strategy
- OKR alignment: [which OKRs this serves]
- Primary topics: [2-3 themes]
- Target audience: [who]
## Schedule
| Week | Type | Topic | Channel | Status |
|------|------|-------|---------|--------|
| W1 | Blog post | [topic] | razbakov.com | draft/published |
| W1 | Thread | [topic] | X/Threads | draft/published |
| W2 | YouTube | [session topic] | ai-study-group | draft/published |
| W2 | Social | [poster topic] | IG/LinkedIn | draft/published |
| W3 | Blog post | [topic] | razbakov.com | draft/published |
| W4 | Newsletter | [monthly roundup] | email | draft/published |
## Content Ideas Backlog
- [ ] [idea from sessions/Telegram inbox]
When: "generate YouTube metadata for [video]" or after ai-study-group recording
Process:
ai-study-group/meetings/), read ittranscribe-via-faster-whisper skill firstOutput template:
## YouTube Metadata
**Title:** [under 60 chars, keyword-front-loaded]
**Description:**
[First 2 lines: hook + value proposition — these show in search]
Timestamps:
00:00 — [topic]
MM:SS — [topic]
[2-3 sentences expanding on the content]
Links:
- [relevant project URLs]
- Subscribe: [channel URL]
**Tags:** [10-15 comma-separated tags, mix of broad and specific]
**Thumbnail text:** [2-4 words for overlay]
When: "analytics report" or end of month
Process:
Output template — save to ikigai/marketing/analytics-YYYY-MM.md:
# Analytics Report — YYYY-MM
## Summary
| Metric | This Month | Last Month | Change |
|--------|-----------|------------|--------|
| Unique visitors | N | N | +/-N% |
| Page views | N | N | +/-N% |
| Bounce rate | N% | N% | +/-N% |
| Avg session | Ns | Ns | +/-Ns |
## Top Pages
1. [page] — N views
2. [page] — N views
## Traffic Sources
- Organic: N%
- Direct: N%
- Social: N%
- Referral: N%
## SEO Performance
- Indexed pages: N/N
- Search impressions: N
- Search clicks: N
- Avg position: N
## Recommendations
1. [action based on data]
When: "content-seo sprint"
Runs all workflows in sequence:
content/blog/ with markdown frontmatterweb100/leads/leads/outreach_queue.csvdevelopment
Seed a new or empty Instagram account with a 9-post grid (3×3) so the profile looks established the moment a new visitor lands. Designed for festivals, new businesses, product launches, conferences, communities — any time an empty IG profile would hurt conversion from external traffic (QR scans, flyer drops, cross-promo). Generates assets via /image-from-gemini (per content-publishing rules — never HTML), writes captions with hashtag sets, and outputs a posting order + cadence plan. Trigger generously: phrases like '9 posts for instagram', 'fill my IG', 'starter grid', 'launch grid', 'instagram seed', '9-post grid', 'IG account not to look empty', 'first instagram posts', 'feed bootstrap', '3x3 grid', 'instagram launch content'. Even if the user mentions only one piece (just the images, just the captions, just the order), use this skill — the grid only works as an integrated bundle.
testing
Translate one English blog post into multiple target languages via parallel sub-agents, preserving frontmatter conventions, hero image, and brand voice. Use when the user shares a published English post URL or markdown path and says 'translate it', 'add other languages', 'publish in DE/ES/RU/UK', 'translate to 5 languages', or asks for localized versions of a specific post.
development
Build a complete press kit for an event, product launch, or campaign — in multiple languages — and publish it as a shareable Google Drive folder ready to send to journalists, partners, or a delegate. Produces press releases (typically DE/EN/ES, or configurable), uploads press photos and flyers, creates an Overview document for at-a-glance briefing, and creates a Handover document with pending tasks, contacts, risks, and decisions so press distribution can be delegated. Use when the user says 'I need a press release', 'create a press kit', 'press release in X languages', 'set up a Drive folder for press', 'handover doc for someone else to run press', or has an upcoming announcement that needs to be sent to media. Trigger generously: even partial requests (just a press release, just a flyer folder) typically evolve into the full kit.
development
Track ticket sales for a live event (concert, festival, conference, workshop) with daily snapshots, generate a burndown chart comparing actual sales to ideal-linear targets and tier-cumulative milestones, and report whether the event is on pace. Use when the user asks how sales are going, wants to know if their event will sell out, asks for a daily sales report, wants to set up sales tracking for an upcoming event, or asks about ticket pace / velocity / projection. Trigger generously: phrases like 'how is concert sales going', 'burndown for my event', 'are we going to sell out', 'sales velocity', 'daily ticket chart', 'how many tickets do we need to sell', or any case where the user has a ticketed event with a fixed sales window and wants visibility on pacing.