- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add posit-dev/skills --skill release-post -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add posit-dev/skills --skill release-post -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add posit-dev/skills --skill release-post -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add posit-dev/skills --skill release-post -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/posit-dev/skills/tree/HEAD/open-source/release-post來自發布者
Create professional R/Python package release blog posts following Tidyverse or Shiny blog conventions.
scripts/get_contributors.R to generate acknowledgmentsThis skill supports two blog platforms with different formatting requirements:
Tidyverse blog (tidyverse.org)
references/tidyverse-formatting.mdShiny blog (shiny.posit.co)
references/shiny-formatting.mdFirst, determine which platform the post is for, then follow the general workflow and apply platform-specific formatting.
These steps apply to both platforms. Content guidelines are based on Tidyverse best practices but adapt them as needed for Shiny posts.
Collect required information:
Create the post outline following this order:
Frontmatter: Platform-specific YAML (see formatting references)
Title and Opening:
Main Content (choose appropriate sections):
Acknowledgements (when appropriate):
scripts/get_contributors.RFollow the best practices in references/content-guidelines.md:
Convert NEWS.md bullets to blog-friendly content:
For Tidyverse posts, read references/tidyverse-formatting.md and apply:
slug, photo.url, photo.authorpackagename-x-y-z (hyphens replace dots)r language identifierFor Shiny posts, read references/shiny-formatting.md and apply:
Run the contributor script:
Rscript scripts/get_contributors.R "owner/repo"
Or with a specific starting tag for the previous version (or tag used for last release post):
Rscript scripts/get_contributors.R "owner/repo" "v1.0.0"
Copy the markdown output into the Acknowledgements section.
Platform-agnostic checklist:
`function()`Platform-specific checklist:
Tidyverse:
package-x-y-z (hyphens, not dots)Shiny:
&desc, *desc)open-graph, twitter-card)Load these as needed for detailed guidance:
references/content-guidelines.md - General best practices for all release posts:
references/tidyverse-formatting.md - Tidyverse blog requirements:
references/shiny-formatting.md - Shiny blog requirements:
scripts/get_contributors.R: Fetch formatted contributor list using usethis::use_tidy_thanks()references/content-guidelines.md: General content best practices (platform-agnostic)references/tidyverse-formatting.md: Tidyverse-specific formatting requirementsreferences/shiny-formatting.md: Shiny-specific formatting requirements---
output: hugodown::hugo_document
slug: package-x-y-z
title: package x.y.z
date: YYYY-MM-DD
author: Your Name
description: >
Brief description
photo:
url: https://unsplash.com/photos/id
author: Photographer Name
categories: [package]
tags: [package]
---
# package x.y.z
We're pleased to announce the release of package x.y.z...
```r
install.packages("package")
```
...
## Acknowledgements
A big thank you to all the folks who helped make this release happen:
[Contributors from get_contributors.R]
---
title: Package Name x.y.z
description: &desc |
Brief description of the release.
author: "Your Name"
date: "YYYY-MM-DD"
image: feature.png
open-graph:
image: feature.png
description: *desc
twitter-card:
image: feature.png
description: *desc
---
# package x.y.z
We're excited to announce package x.y.z...
[Installation for Python or R]
...
>
---name: release-postdescription: >---# open-source/release-post/SKILL.md常見問題
從發布者下載 open-source/release-post/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/posit-dev/skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。