Claude Code skill for an Astro MDX blog draft
Turn verified observations into an Astro blog draft with an opening hook, context, friction, and a conclusion that follows from the facts.
中文Install in Claude Code
Open an Astro project in Claude Code with the `@astrojs/mdx` integration enabled in `astro.config.ts`. Confirm that its post collection reads `src/content/posts/`. The source site uses Moeyua’s MIT-licensed Typography theme. This exercise produces a local MDX draft.
- Review `.claude/skills/blog-writing/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/blog-writing/` in your project and save the reviewed file as `.claude/skills/blog-writing/SKILL.md`.
- Start Claude Code from that project's root, then select `/blog-writing` in the slash menu.
Example task
Draft a plain-language note for library volunteers. The loan sheet lists 12 games lent in this batch. The returns box contains one returned game from that same batch, and the loan sheet still shows the original count. Explain why loans and returns should be recorded in separate columns.
`{"batch":"volunteer-game-loans","topic":"board game returns","reader":"library volunteers","tone":"plain","date":"2026-10-23","loanSheetCount":12,"returnsBoxCountFromThisBatch":1,"point":"record loans and returns in separate columns"}`What to check
Save the draft as `src/content/posts/2026-10-23-board-game-returns.mdx`. The `pubDate` matches the filename date, the `slug` matches the filename suffix, and `draft` stays `true`. The four sections move from the returns-box hook to the loan-sheet context, the counting problem, and the conclusion. The loan sheet shows 12 and the returns box shows 1 for the same batch, so 11 remain outstanding.
---
title: "Board Game Returns"
pubDate: 2026-10-23
categories: ["Library"]
description: "A short note for library volunteers."
slug: board-game-returns
draft: true
---
---
## 一、One game in the box
One board game sat in the returns box. How many from this batch were still out?
---
## 二、The loan sheet
The volunteers checked the loan sheet for the same batch. It showed 12 loans.
---
## 三、Two incomplete counts
The box showed one return. The loan sheet still showed the original count, so neither place gave the number still out.
---
## 四、結語
Record loans and returns in separate columns. With one game returned, 11 remain outstanding.Original SKILL.md on GitHub · Updated
Frequently asked question
Which details should I check in the draft metadata?
Check that the MDX filename date matches pubDate and its suffix matches slug. Keep the draft flag true for a later preview.