Agent Skills › emavgl/oinkoin › write-article

write-article

GitHub

用于为 Oinkoin 网站创建或更新博客文章，支持按主题或版本号生成内容。遵循特定 Markdown 规范、Frontmatter 格式及页脚下载链接约定，确保文章符合网站发布标准。

website/.claude/skills/write-article/SKILL.md emavgl/oinkoin

Trigger Scenarios

用户要求撰写博客文章用户要求发布版本说明用户要求向网站博客添加内容

Install

npx skills add emavgl/oinkoin --skill write-article -g -y

More Options

Non-standard path

npx skills add https://github.com/emavgl/oinkoin/tree/master/website/.claude/skills/write-article -g -y

Use without installing

npx skills use emavgl/oinkoin@write-article

指定 Agent (Claude Code)

npx skills add emavgl/oinkoin --skill write-article -a claude-code -g -y

安装 repo 全部 skill

npx skills add emavgl/oinkoin --all -g -y

预览 repo 内 skill

npx skills add emavgl/oinkoin --list

SKILL.md

Frontmatter

{
    "name": "write-article",
    "description": "Creates or updates blog articles for the Oinkoin website. Use when the user wants to write a blog post, publish a release article, or add content to the website blog.",
    "argument-hint": "[topic or release-version]"
}

Skill: write-article

Write a blog article for the Oinkoin website.

Usage

/write-article [topic]
/write-article 2.1.0

Blog article system

Articles live in website/src/content/blog/ as Markdown files.
The file name becomes the URL slug (e.g. linux-beta.md → /blog/linux-beta).
Use kebab-case for filenames: my-new-feature.md.

Frontmatter schema

Every article must have frontmatter between --- delimiters:

---
title: 'Article Title'       # required — page title & blog listing
description: 'Short summary' # required — shown in listing & meta tags
pubDate: 2026-05-03           # required — ISO date (YYYY-MM-DD)
updatedDate: 2026-05-10       # optional — if article is revised
heroImage: '/path/image.png'  # optional — not currently used in template
---

Markdown content guidelines

Headings

Start with ## (h2) for top-level sections. The article title becomes the page <h1> automatically.
Use ### (h3) for sub-sections under an ##.
Headings render with 2px larger font than body text and 1.5em top margin.

Body text

Regular paragraphs automatically use 1.15rem font size.
Bold with **double asterisks**.
Lists use blue (#2563eb) markers.

Separator

Use --- on its own line to insert a horizontal rule. This is typically used before the footer/download links section. It renders with 2.5em vertical margin.

Images

Wrap images in a centered div to match existing posts:

<div style="text-align:center; margin: 2em 0;">
  <img src="/path/to/image.png" alt="Description" style="width:96px; height:96px; display:inline-block;" />
</div>

Place images in website/public/.

Footer / download links convention

End articles with a separator, then a heading, then download links:

---

## Upgrade Now

Download version **X.Y.Z** from [Google Play](https://play.google.com/store/apps/details?id=com.emavgl.piggybank) or grab the APK directly from our [GitHub releases page](https://github.com/emavgl/oinkoin/releases/tag/X.Y.Z).

Have questions or feedback? Open an issue or start a discussion on [GitHub](https://github.com/emavgl/oinkoin).