Agents platform-astro

Astro/AstroPaper platform configuration for the blog-workflow plugin

install

source · Clone the upstream repo

git clone https://github.com/aRustyDev/agents

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aRustyDev/agents "$T" && mkdir -p ~/.claude/skills && cp -r "$T/content/plugins/blog-workflow/skills/platforms/astro" ~/.claude/skills/arustydev-agents-platform-astro && rm -rf "$T"

manifest: content/plugins/blog-workflow/skills/platforms/astro/SKILL.md

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