platform-astro

Astro/AstroPaper Platform Skill

This skill provides Astro and AstroPaper-specific configuration for the blog-workflow plugin.

Platform Configuration

• Platform: Astro/AstroPaper
• Published posts path: src/data/blog/
• Build output: dist/
• Build command: astro build
• Dev server: astro dev
• Date field: pubDatetime
• Updated field: modDatetime
• Image field: ogImage
• Canonical field: canonicalURL
• Detection files: astro.config.mjs, astro.config.ts

Platform Summary

Setting	Value
Published posts	src/data/blog/
Build output	dist/
Build command	astro build
Dev server	astro dev
Date field	pubDatetime
Updated field	modDatetime
Image field	ogImage
Canonical field	canonicalURL

Frontmatter Quick Reference

Required Fields

Field	Type	Notes
id	UUIDv4	Stable artifact identifier
title	string	Max 60 chars for SEO
description	string	150-160 chars for SEO
pubDatetime	ISO 8601	Must include timezone
tags	string[]	At least one required

Optional Fields

Field	Default	Notes
modDatetime	null	Set on updates
author	"aRustyDev"	Configurable per-project
featured	false	Show on homepage
draft	true	Exclude from build
ogImage	""	Open Graph image path
canonicalURL	""	For cross-posted content

Common Mistakes

Wrong	Correct	Reason
date:	pubDatetime:	AstroPaper naming convention
image:	ogImage:	AstroPaper naming convention
canonical:	canonicalURL:	AstroPaper naming convention
type:	(remove)	Not in AstroPaper schema

Detection

This platform is detected when any of these files exist in the project root:

• astro.config.mjs
• astro.config.ts

Reference

For detailed documentation, see:

• Frontmatter Schema - Complete field definitions and validation rules
• Publishing Guide - Build, deploy, and rollback procedures
• Directory Conventions - Content locations and file structure