# Ssg Whiz New Article

> Create a new blog article for a Rust static site that uses ssg_whiz. Use when the user wants a new article added under crates/<site>/content/blog/<slug>/ with a matching PageSummary entry added to crates/<site>/src/blog_summary.rs.

- Skill: `bionic-gpt/ssg-whiz-new-article` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bionic-gpt/ssg-whiz-new-article`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bionic-gpt/ssg-whiz-new-article/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bionic-gpt (https://skillmd.com/u/bionic-gpt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bionic-gpt/ssg-whiz-new-article

---


# SSG Whiz New Article

Use this skill when a user wants to add a new blog post to an existing `ssg_whiz` site in this workspace.

## Inputs

- Required: article title
- Optional: crate name, slug, publish date, description, author name, author image, hero image

If the user does not provide a crate, infer it from context or ask.
If the user does not provide a slug, derive one from the title.
If the user does not provide a date, default to today.

## Workflow

1. Ask for the article title if it is missing.
2. Identify the target crate, usually `crates/<site>`.
3. Inspect an existing article in `crates/<site>/content/blog/` and the matching `crates/<site>/src/blog_summary.rs` before editing.
4. Create a new folder at `crates/<site>/content/blog/<slug>/`.
5. Add `index.md` with a basic article stub.
6. If the user wants a placeholder image, add a simple generic image file to the same folder and reference it from the markdown and summary.
7. Update `crates/<site>/src/blog_summary.rs` by inserting a new `PageSummary` entry near the top of the list.
8. Run `cargo check -p <site>` if validation is useful and feasible.

## Article Stub

Keep the initial article simple and easy to revise. A good default is:

```md
# <Title>

## Summary

Short summary of the article.

![Hero image](hero.png "<Title>")

## Introduction

Draft introduction text.

## Key Points

1. First point
2. Second point
3. Third point

## Conclusion

Draft closing paragraph.
```

If the repository's existing articles use a different style, follow the local pattern instead of this stub.

## Updating blog_summary.rs

Match the existing `PageSummary` shape already used in the crate:

- `date`
- `title`
- `description`
- `folder`
- `markdown`
- `image`
- `author`
- `author_image`

Use the new article folder consistently in:

- `folder: "blog/<slug>/"`
- `markdown: include_str!("../content/blog/<slug>/index.md")`
- `image: Some("/blog/<slug>/<image-file>")` when an image exists

Insert the new entry in descending date order unless the file clearly follows a different ordering rule.

## Notes

- Prefer copying the conventions already present in the target crate over inventing a new structure.
- Keep the first draft minimal unless the user asks for a full article.
- If author metadata is consistent across existing posts, reuse that default unless the user asks for something else.