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?