Create Content Skill

This skill creates new markdown content files for the readme-pages Astro site.

Content Types

Notes (src/content/notes/)

Dated entries like blog posts, updates, or time-sensitive content.

Filename convention: YYYY-MM-DD-slug.md (date prefix optional but recommended)

• Example: 2025-12-25-my-new-note.md
• Date extracted automatically from filename prefix

Frontmatter:

---
title: "Note Title"           # Required (auto-generated from filename if omitted)
date: 2025-12-25              # Required (auto-extracted from filename or defaults to today)
description: "Summary"        # Optional, max 500 chars
tags:                         # Optional, lowercase alphanumeric with hyphens
  - javascript
  - tutorial
draft: false                  # Optional, set true to hide from publication
---

Pages (src/content/pages/)

Evergreen documentation pages without dates.

Filename convention: slug.md

• Example: getting-started.md

Frontmatter:

---
title: "Page Title"           # Required (auto-generated from filename if omitted)
description: "Description"    # Optional, max 500 chars
order: 1                      # Optional, controls sidebar ordering
---

Workflow

To create a new note:

1. Determine the slug from the user's topic (kebab-case)
2. Use today's date or a specified date
3. Create the file at src/content/notes/YYYY-MM-DD-slug.md
4. Include frontmatter with title, date, and optional tags/description
5. Add the markdown content

To create a new page:

1. Determine the slug from the user's topic (kebab-case)
2. Create the file at src/content/pages/slug.md
3. Include frontmatter with title and optional description/order
4. Add the markdown content

Validation Rules

• Title: 1-200 characters, required
• Date (notes only): Must be between 2000-01-01 and today (no future dates)
• Tags: Lowercase alphanumeric with hyphens only, 1-50 chars each
• Description: Max 500 characters

Auto-Generation

The site automatically handles:

• Missing title: Generated from filename (converted to Title Case)
• Missing date (notes): Extracted from YYYY-MM-DD- prefix, or defaults to today
• Table of contents from headings
• Reading time estimates
• Last modified dates from git history
• Related notes based on tag overlap

Examples

Minimal Note

---
title: "Getting Started with TypeScript"
date: 2025-12-25
tags:
  - typescript
  - tutorial
---

Your content here...

Minimal Page

---
title: "Installation Guide"
order: 1
---

Your content here...

Ask User For

When creating content, gather:

1. Type: Note or Page?
2. Title: What should it be called?
3. Content: What should it contain? (or ask if they want to provide it)
4. Tags (notes only): Any tags to categorize it?
5. Draft: Should it be published immediately or saved as draft?