---
name: blogpost-creator
description: Create new blogposts from a template or linkposts using the hydrate command.
allowed-tools: Read, Grep, Glob, WebFetch, Bash(go run *), Edit, Write
---

# Blog Post Creator

Create new blog posts for Xe's site using the hydrate command.

## Usage

Invoke this skill when you want to create a new blog post. The skill will prompt you for:

- **Post type**: blog, linkpost, note, talk, or xecast
- **Title**: The title of your post (for linkposts, can auto-fetch from URL)
- **Description**: A brief description/summary (for linkposts, can auto-fetch from URL)
- **Link URL**: (required for linkposts) The URL this post should redirect to
- **Publication date**: (optional, for linkposts can auto-extract from the page, defaults to today if not found)
- **Custom slug**: (optional, for linkposts will auto-extract from URL basename if not provided)

## What it does

1. **For linkposts**: Extracts slug from URL basename if no custom slug provided (e.g., https://example.com/blog/my-post becomes "my-post")
2. **For other post types**: Generates a URL-friendly slug from your title (or uses your custom slug)
3. **For linkposts**: Can auto-fetch title, description, and publication date from the provided URL
4. Validates that linkposts have a URL provided (prompts if missing)
5. Runs `go run ./cmd/hydrate <kind> <slug>` with the appropriate parameters
6. For linkposts: Updates the `redirect_to` field in the frontmatter with the provided URL
7. **For linkposts**: Adds fetched summary to the post body if available
8. Opens the created file in VS Code for editing
9. Shows you the file location for reference

## File structure

Blog posts are created in:

- `lume/src/blog/<year>/<slug>.mdx` for blog and linkpost
- `lume/src/notes/<year>/<slug>.mdx` for notes
- `lume/src/talks/<year>/<slug>.mdx` for talks
- `lume/src/xecast/<year>/<slug>.mdx` for xecast

## Frontmatter templates

Each post type has its own frontmatter template:

**Blog posts** include hero image configuration:

```yaml
---
title: ""
desc: ""
date: YYYY-MM-DD
hero:
  ai: ""
  file: ""
  prompt: ""
  social: false
---
```

**Link posts** include a redirect URL:

```yaml
---
title: ""
date: YYYY-MM-DD
redirect_to: "https://example.com"
---
```

**Other types** (notes, talks, xecast) have simpler frontmatter:

```yaml
---
title: ""
desc: ""
date: YYYY-MM-DD
---
```

## Linkpost Special Features

Linkposts have enhanced functionality:

1. **Automatic slug extraction**: If no custom slug is provided, the skill will extract the basename from the URL (e.g., `https://example.com/blog/my-post` becomes `my-post`)

2. **Auto-fetching content**: The skill can automatically fetch the webpage to extract:
   - The page title (used as the post title)
   - A summary/description (added to the post body)
   - The publication date (used as the post date, defaults to today if not found)
   - This saves time and ensures accurate representation of the linked content

Use the extract-meta.js file in this folder to extract meta-information from webpages:

```bash
node extract-meta.js <url>
```

3. **URL handling**: The skill handles redirects and will follow them to get the final content for title/description extraction

## Example Linkpost Workflow

When creating a linkpost with a URL like `https://anubis.techaro.lol/blog/2025/file-abuse-reports`:

1. Skill detects it's a linkpost with a URL
2. Extracts slug "file-abuse-reports" from URL basename
3. Fetches the webpage to get:
   - The actual title: "Taking steps to end traffic from abusive cloud providers"
   - A summary of the content for the post body
   - The publication date from the page (e.g., "2025-01-15")
4. Creates the post with auto-generated slug, fetched title, and extracted date
5. Adds the summary to the post body for context
6. Updates the redirect_to field with the provided URL

## Date Extraction Details

The skill will look for publication dates in various formats:

- **Meta tags**: `<meta property="article:published_time" content="2025-01-15">`
- **JSON-LD structured data**: `"datePublished": "2025-01-15"`
- **HTML5 semantic elements**: `<time datetime="2025-01-15">`
- **Common date patterns in the page content**
- **URL patterns**: Extracts date from URL structure like `/blog/2025/my-post`

If no date is found, it defaults to today's date.