Readme Pages

readme-pages Publishing Skill

Create publish-ready Markdown files for the readme-pages Astro site.

Content Locations

• src/content/notes/ — dated notes/essays (default)
• src/content/recipes/ — cooking recipes
• src/content/pages/ — site pages (only when explicitly requested)

Workflow

1. Determine content type (note, recipe, or page)
2. Generate filename: YYYY-MM-DD-slug.md using Europe/Copenhagen date
3. Create frontmatter + content following templates
4. Save to /mnt/user-data/outputs/ and present file

Filename Rules

Pattern: YYYY-MM-DD-slug.md

Slug requirements:

• Lowercase only (a-z, 0-9, hyphen)
• No spaces, underscores, or dots
• 3-8 words, hyphen-separated

Frontmatter

Notes (required fields)

---
title: "Title Here"
date: 2025-12-26
description: "1-2 sentence summary."
tags: ["tag-one", "tag-two"]
---

Recipes (additional fields)

---
title: "Recipe Title"
date: 2025-12-26
description: "Short description."
tags: ["dessert", "baking"]
prepTime: "15 minutes"
cookTime: "30 minutes"
servings: 4
difficulty: "easy"
---

Critical Rules

1. Title only in frontmatter — never repeat as # Title in body
2. Body starts with intro paragraph, first heading is ## (H2)
3. Tags must be kebab-case — see references/tags.md for current taxonomy
4. Always output downloadable file — save to outputs directory

Content Structure

Notes

1. Intro (2-4 sentences)
2. Main content with H2/H3 sections
3. "What to do next" (3-7 bullets) for how-to posts
4. "Sources" if citing external facts

Recipes

1. Intro (1-2 sentences about the dish)
2. ## Ingredients (with sublists for categories)
3. ## Instructions (numbered steps)
4. ## Tips (optional)
5. ## Storage (optional)

Voice

• Practical, direct, specific
• Enterprise-leaning (architecture, tradeoffs, verification)
• Avoid hype; focus on what to do and how to validate
• Use examples over abstractions

Templates

See references/examples.md for copy-paste templates.

Tag Selection

See references/tags.md for current taxonomy. Use 2-6 tags. Prefer existing tags.