SEO Guide for Cogniba Blog
Defines SEO requirements and a step-by-step workflow for writing and publishing blog posts with proper metadata, images, and internal links.
What this file does
Defines SEO requirements and a step-by-step workflow for writing and publishing blog posts with proper metadata, images, and internal links.
When to use it
- You want to enforce consistent SEO practices across a team blog
- You need a repeatable checklist for publishing posts with frontmatter and social images
- You are setting up a blog that uses MDX files with dark-mode OG images
- You want to avoid duplicate blog topics in a shared repository
Assumes this stack
SEO Guide for Cogniba Blog
This guide explains how to create and optimize blog posts for maximum search engine visibility.
1. Creating a New Post
- Create a new
.mdxfile insrc/content/blog/. - Name the file using a "slug" format (lowercase, hyphens instead of spaces).
- Example:
how-to-improve-working-memory.mdx - URL will be:
cogniba.com/blog/how-to-improve-working-memory
- Example:
Required: Image Prompt Comment (Dark Mode)
At the top of every post (immediately after frontmatter), include a JSX comment block that contains an AI image prompt for the OG image.
- Use MDX-safe JSX comments:
{/* ... */}(do not use<!-- ... -->). - The generator does not know our brand; do not mention Cogniba or "brand colors".
- Be explicit about dark-mode colors using the exact hex values from
src/styles/globals/globals.css(use the.darkpalette). - State: 1200x630 PNG, no watermark, no people (unless intentionally needed), keep text within safe margins.
- Provide the exact headline/subtitle text that should appear on the image.
0. Avoid Duplicates (Required)
Before writing a post, check BLOGPOSTS.md so we don't publish the same topic twice.
- If a similar post already exists, update it or pick a different angle.
- After publishing, add the post to
BLOGPOSTS.md(title, slug, date, and 1-line description).
2. Frontmatter (The Metadata)
Every post must start with "Frontmatter" block between three dashes ---. This data controls how your post appears in Google and social media.
---
title: "The Ultimate Guide to N-Back Training"
description: "Learn how the n-back task improves IQ and working memory. We explain the science and how to start training today."
date: "2024-03-20T12:00:00Z"
image: "/images/blog/n-back-guide.png"
author: "Marcos Hernanz"
role: "Founder & CEO"
tags: ["n-back", "brain-training", "science"]
---
Field Breakdown
- title: The
<h1>of the page and the blue link in Google. Keep it under 60 characters. Make it catchy but accurate. - description: The short text under the link in Google. Keep it under 160 characters. Include your main keywords (e.g., "n-back", "IQ").
- date: Prefer an ISO timestamp in UTC for scheduled publishing (e.g.
2026-02-10T12:00:00Z). Date-only (YYYY-MM-DD) is ok if you don't care about publish hour. - image: The "social card" image shown on Twitter/LinkedIn.
- Place images in
public/images/blog/. - Recommended size: 1200x630 pixels.
- Place images in
- tags: Used for internal organization and potentially future filtering.
3. Writing Content for SEO
Keywords
Identify the main phrase users search for (e.g., "increase working memory").
- Include it in the Title.
- Include it in the Description.
- Include it in the first 100 words of the content.
- Include it naturally 2-3 times throughout the post.
Structure (Headings)
Use headings to structure your content. Google loves hierarchy.
#(H1) is automatic (from the title), so start your content with text or H2.- Use
##(H2) for main sections. - Use
###(H3) for subsections.
Formatting
- Use bold for key concepts (don't overdo it).
- Use bullet points (like this list) for readability.
- Short paragraphs are better for mobile readers.
Links
- Internal Links: Link to other Cogniba pages (e.g., "Check out our pricing page" or "Read our research"). This is crucial for crawling.
- External Links: Link to authoritative sources (e.g., "According to a study by Jaeggi et al.").
4. Checklist Before Publishing
- Filename is URL-friendly (
my-post-name.mdx). - Title is compelling and < 60 chars.
- Description is unique and < 160 chars.
- Image exists in
public/images/blog/and is 1200x630px. - Content uses H2 and H3 headings correctly.
- You have linked to at least one other page on Cogniba.com.
- You updated
BLOGPOSTS.md.
What's inside
6 sections covering post creation, frontmatter fields, keyword placement, heading structure, formatting, and a pre-publish checklist
Change this for your project
- Replace
cogniba.comwith your own domain - Replace
src/content/blog/with your blog's content directory - Replace
public/images/blog/with your image storage path - Replace
BLOGPOSTS.mdwith your own topic tracking file name
Where it goes
A prompt collection. Copy the individual prompts you need rather than the whole file.
Worth borrowing
- Requiring an AI image prompt comment with exact hex colors for dark-mode OG images
- Using a pre-publish checklist that includes internal linking and duplicate checking
Related Documents
starProject
Lists 120+ starred open-source projects across AI, DevOps, Flutter, and web development for discovery and inspiration.
midjourney-expert
Serves as a reference for Midjourney V7/Niji 7 prompting, covering parameters, reference systems, editing tools, and moderation workarounds.
🎣 Hooks & Headlines Generator
Generates 20, 30 headline variations across 10 proven formulas, with psychological reasoning and platform-specific best practices.
Daily Agent Tasks Framework
Gives you a daily structure for assigning strategic work to Claude and development work to Codex, organized by project priority and current sprint.