AgentSkillsCN

readme-pages

为托马斯基于 Astro 的 GitHub Pages 站点（readme-pages）提供发布辅助功能。可为笔记、食谱及各类页面生成适合发布的 Markdown 文件。当您被要求为 thomasrohde.github.io/readme-pages 站点撰写博客文章、专题文章、笔记、食谱，或创作其他内容时，请使用此工具。此外，凡涉及“发布”“博客”或“我的站点”等内容需求时，亦可一并使用。

SKILL.md
--- frontmatter
name: readme-pages
description: Publishing assistant for Thomas's Astro-based GitHub Pages site (readme-pages). Creates publish-ready Markdown files for notes, recipes, and pages. Use when asked to write blog posts, articles, notes, recipes, or content for the readme-pages site at thomasrohde.github.io/readme-pages. Also use for content requests mentioning "publish", "blog", or "my site".

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)

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

Recipes (additional fields)

yaml
---
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.