Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

docs(skills): record where blog images live in the dev skill (#343)

Yaowei Zheng08155d4786ee
diff --git a/.agents/skills/penguin-harness-dev/SKILL.md b/.agents/skills/penguin-harness-dev/SKILL.md
index dd085970..1ad9773f 100644
--- a/.agents/skills/penguin-harness-dev/SKILL.md
+++ b/.agents/skills/penguin-harness-dev/SKILL.md
@@ -1,6 +1,6 @@
---
name: penguin-harness-dev
-description: Use when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release workflow; writing or auditing changelog entries; deciding what to do about data already on disk; or auditing prose that reads like a leaked authoring session. Covers the two-repo symlink layout, the CI-parity verification chain, the record-and-ship contract, and the seams that are intentional.
+description: Use when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release workflow; writing or auditing changelog entries; writing a blog post or capturing release screenshots; deciding what to do about data already on disk; or auditing prose that reads like a leaked authoring session. Covers the two-repo symlink layout, the CI-parity verification chain, the record-and-ship contract, where blog media is hosted, and the seams that are intentional.
---
# Developing PenguinHarness
@@ -74,6 +74,16 @@ The PR number exists only once the PR is open: open it, then add the links in a
An entry ships **inside the PR that makes the change** — there is no separate aggregate PR. Released version folders are frozen. `RELEASE.md` is written at release preparation and must be committed **before** the tag — the workflow reads it from the tag's own checkout.
+## Blog posts, and where their images live
+
+A post is a pair under `packages/landing/content/blog/`: `<slug>.en.md` and `<slug>.zh.md`, each with `title` / `date` / `category` / `excerpt` frontmatter. Same rule as changelog entries — one without the other is unfinished.
+
+**The images are not in this repo.** Screenshots and demo videos live in the sibling `Prism-Shadow/penguin-harness-community` repo, under `blog-assets/` and `videos/`. A published post's screenshots are never deleted, so that asset class grows without bound in the number of posts written; keeping it out of this history keeps everyone's clone small.
+
+**Posts still write a repo-local path.** Reference an image as `/blog-assets/<name>` — both `![alt](…)` and the raw `<img src="…">` some posts use — and let the renderer resolve it: `blogAssetUrl` in `packages/landing/src/lib/links.ts`, applied by the `img` adapter in `src/pages/blog-post.tsx`. Never paste the raw `raw.githubusercontent` URL into a post. One source of truth for the host, Markdown that stays readable and diffable, and moving the host again is a one-line change instead of a sweep over every post.
+
+Release screenshots are captured, not mocked up: drive the app through the Playwright e2e harness in `packages/web/e2e/` with its mock LLM, against a scratch `PENGUIN_HOME` — never `~/.penguin`, which is the developer's real data. Shoot at `deviceScaleFactor: 2`, crop to the feature rather than the whole window, and check the frame for what must not ship publicly: absolute paths carrying a home directory, API keys, and mock-model filler text.
+
## Changing the built-in model catalog
`packages/core/src/state/model-catalog.ts` is the single source of truth for presets, shared by core's defaults, the server's initial config, and web/CLI display. It is a *catalog*, not a routing table — AgentHub owns routing.
diff --git a/changelog/unreleased/2026-08-19-dev-skill-blog-media.md b/changelog/unreleased/2026-08-19-dev-skill-blog-media.md
new file mode 100644
index 00000000..4ca32b51
--- /dev/null
+++ b/changelog/unreleased/2026-08-19-dev-skill-blog-media.md
@@ -0,0 +1,16 @@
+# The dev skill records where blog images live
+
+- **Date:** 2026-08-19
+- **Type:** process
+- **Scope:** `skills`
+
+[中文版](2026-08-19-dev-skill-blog-media.zh.md)
+
+`.agents/skills/penguin-harness-dev/SKILL.md` gained a "Blog posts, and where their images live" section covering the post pair under `packages/landing/content/blog/`, the community repo that hosts the images, the `/blog-assets/<name>` path posts write instead of the host URL, and how release screenshots are captured.
+
+## Details
+
+- Screenshots and demo videos live in the sibling `Prism-Shadow/penguin-harness-community` repo under `blog-assets/` and `videos/`, not in this one; the section states why, so the arrangement is not undone by someone who reads it as an accident.
+- Posts reference `/blog-assets/<name>`, resolved at render time by `blogAssetUrl` in `packages/landing/src/lib/links.ts` and the `img` adapter in `src/pages/blog-post.tsx`. Pasting a raw host URL into a post is called out as the thing not to do.
+- Release screenshots are driven through the Playwright e2e harness with its mock LLM against a scratch `PENGUIN_HOME`, at `deviceScaleFactor: 2`, with a frame check for home-directory paths, API keys and mock-model filler.
+- The skill's frontmatter description now names blog posts and screenshots among its triggers.
diff --git a/changelog/unreleased/2026-08-19-dev-skill-blog-media.zh.md b/changelog/unreleased/2026-08-19-dev-skill-blog-media.zh.md
new file mode 100644
index 00000000..abd1738a
--- /dev/null
+++ b/changelog/unreleased/2026-08-19-dev-skill-blog-media.zh.md
@@ -0,0 +1,16 @@
+# 开发 skill 记录了博客图片的存放位置
+
+- **Date:** 2026-08-19
+- **Type:** process
+- **Scope:** `skills`
+
+[English](2026-08-19-dev-skill-blog-media.md)
+
+`.agents/skills/penguin-harness-dev/SKILL.md` 新增「Blog posts, and where their images live」一节,涵盖 `packages/landing/content/blog/` 下成对的文章文件、托管图片的 community 仓库、文章中应当书写的 `/blog-assets/<name>` 路径而非托管地址,以及发布截图的采集方式。
+
+## 细节
+
+- 截图与演示视频存放在同级的 `Prism-Shadow/penguin-harness-community` 仓库的 `blog-assets/` 与 `videos/` 下,而不在本仓库;该节写明了这样安排的原因,以免后来者把它当成疏漏而擅自改回来。
+- 文章引用 `/blog-assets/<name>`,由 `packages/landing/src/lib/links.ts` 中的 `blogAssetUrl` 与 `src/pages/blog-post.tsx` 中的 `img` 适配器在渲染时解析。把托管原始 URL 直接粘进文章被明确列为不应做的事。
+- 发布截图通过 `packages/web/e2e/` 的 Playwright 测试设施与其 mock 模型驱动,使用独立的 `PENGUIN_HOME`,以 `deviceScaleFactor: 2` 拍摄,并检查画面中是否混入了家目录路径、API key 和 mock 模型的填充文本。
+- 该 skill 的 frontmatter 描述现在也把博客文章与截图列入触发场景。