You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .agents/skills/create-draft-release-notes/SKILL.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ metadata:
9
9
10
10
## Overview
11
11
12
-
Create a GitHub draft release when possible, organize the generated notes by conventional commit type, and save the organized body back to the draft. If `gh` cannot create or edit the draft, return the organized Markdown in the conversation with manual creation steps. Preserve each release note item exactly; only split accidentally joined bullets, move bullets into sections, and adjust headings. Add a top `## Highlights` section only when the user explicitly asks for highlights.
12
+
Create a GitHub draft release when possible, organize the generated notes by conventional commit type, and save the organized body back to the draft. If `gh` cannot create or edit the draft, return the organized Markdown in the conversation with manual creation steps. Preserve each release note item exactly except stale release PRs; otherwise only split accidentally joined bullets, move bullets into sections, and adjust headings. Add a top `## Highlights` section only when the user explicitly asks for highlights.
13
13
14
14
## Security Notes
15
15
@@ -138,7 +138,7 @@ Use this when the user provides generated release note Markdown and only wants i
Omit the file path to read from stdin. Review that every original item still appears once and non-item sections remain.
141
+
Omit the file path to read from stdin. Review that every retained item appears once and non-item sections remain.
142
142
143
143
## Optional Highlights Workflow
144
144
@@ -154,7 +154,7 @@ Write highlights before `## What's Changed`:
154
154
- Use one `###` heading per highlight.
155
155
- Keep each highlight to a short paragraph plus an optional fenced code example.
156
156
- Include examples only when the API/configuration is clear.
157
-
- Do not rewrite or reorder changelog items below `## What's Changed`.
157
+
- Do not rewrite or reorder retained changelog items below `## What's Changed`.
158
158
- Replace an existing top `## Highlights` block instead of adding another one.
159
159
160
160
Example shape:
@@ -203,6 +203,8 @@ Keep each category in generated top-to-bottom order.
203
203
204
204
## Preservation Rules
205
205
206
+
- Remove bullets that clearly identify a release PR for`$previous_tag` or an older published version, such as `release: v1.0.0`in`v1.0.1` notes; keep current-version and ambiguous items.
207
+
- If anything is removed, list the original bullets verbatim for the user outside the release note body.
206
208
- Do not rewrite bullet text, authors, URLs, PR numbers, package names, scopes, punctuation, or casing.
207
209
- Do not drop comments, `**Full Changelog**`, or other non-item sections.
208
210
- Do not add commentary to the release note itself, except for a requested `## Highlights` section.
Copy file name to clipboardExpand all lines: .agents/skills/pr-creator/SKILL.md
+9-16Lines changed: 9 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
name: pr-creator
3
-
description: Use when asked to create a pull request for this repository. It helps the PR follow the repository's branch safety rules, title convention, pull request template, and concise English writing style.
3
+
description: Create a pull request using repositorybranch rules, title conventions, templates, and concise English descriptions.
4
4
metadata:
5
5
internal: true
6
6
---
@@ -17,7 +17,7 @@ metadata:
17
17
Do not revert unrelated user changes.
18
18
Before creating the PR, ensure the intended changes are committed and never commit directly on the default branch.
19
19
20
-
3.If `.github/PULL_REQUEST_TEMPLATE.md` exists, read it and follow its structure.
20
+
3.Read the repository's PR template when available and follow its current headings and guidance.
21
21
22
22
4. Draft the PR title in the repository's standard format. If the repository uses Conventional Commits, common patterns include:
23
23
-`feat(core): add ...`
@@ -29,20 +29,13 @@ metadata:
29
29
-`release: v1.2.0`
30
30
31
31
5. Write the PR body in concise, clear English.
32
-
- In `Summary`, explain the change context first: the user-facing problem, maintenance goal, or compatibility constraint that makes the change necessary.
33
-
- Prioritize high-signal information: public API changes, behavior changes, breaking changes, migration notes, and important compatibility implications.
34
-
- Then describe the main implementation change only as much as needed to understand the review.
35
-
- Keep the PR body concise and review-oriented: use 1-4 short standalone sentences for typical changes, covering why it matters, what changed, and any reviewer-important impact.
36
-
- Avoid low-signal sections such as `Test plan` or `Validation`, routine verification commands, generated file lists, or obvious implementation details unless the repository template explicitly requires them or the change has unusual validation risk.
37
-
- Good background examples:
38
-
-`This PR adds support for custom logger injection so CLI output can be isolated per instance.`
39
-
-`This PR fixes incorrect padding in URL labels to keep terminal output aligned across different label lengths.`
40
-
-`This PR updates the English docs to clarify how the extraction option works and when to enable it.`
41
-
42
-
6. Fill `Related Links` with issue links, design docs, related PRs, or discussion pages.
43
-
If the PR upgrades an npm dependency, add a link to the upgraded version's release notes or tag page when available.
0 commit comments