article-scaffoldlisted
Install: claude install-skill Kevinnnnn-ai/astronology.dev
# Article Scaffold
Build a static article page from a source folder of markdown and images.
Spec: [docs/superpowers/specs/2026-05-22-article-scaffold-design.md](../../../docs/superpowers/specs/2026-05-22-article-scaffold-design.md)
---
## On Invoke
Announce:
> "Using article-scaffold to build the article: <slug>."
Read the following before doing anything else:
- [docs/code-map.md](../../../docs/code-map.md)
- [docs/superpowers/specs/2026-05-22-article-scaffold-design.md](../../../docs/superpowers/specs/2026-05-22-article-scaffold-design.md)
- [src/js/config.js](../../../src/js/config.js): to determine the next article number and whether `renderArticleCard` is already wired
---
## Phase 1: Read
1. Locate source folder: `src/articles/content/<slug>/`
2. Find the markdown file: Use the first `.md` file alphabetically. If more than one `.md` file exists, warn the user and proceed with the first.
3. Parse frontmatter. If a YAML frontmatter block exists at the top of the file (between `---` delimiters), extract these fields:
| Field | Fallback |
|---|---|
| `title` | First `# H1` heading in the markdown body |
| `tag` | `"General"` |
| `date` | Today formatted as `Mon YYYY` (e.g., `May 2025`) |
| `excerpt` | First non-heading paragraph, truncated to ≤160 characters |
| `hero` | First image file in the folder alphabetically |
4. List all image files in the folder (`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`). Identify the hero image. If the line immediately following the