Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Changes are grouped by date.
- README: Removed VS Code Insiders requirement for `chat.useAgentSkills` directive -- Agent Skills are now available in the standard VS Code release
- `glab` skill: require fully-qualified references (`group/project#N`, `group/project!N`) in all written content (descriptions, comments, notes) to prevent broken cross-project links
- `glab` skill: auto-closing issues on merge via `Closes`/`Fixes` directives in MR descriptions is now optional -- the agent asks the user before including a closing reference, since auto-close is not always desired
- `gh`, `glab`, and `sf-commit-convention` skills: consolidate the "write artifacts in plain prose" guidance into a single section per skill and state explicitly that an active terse output style (e.g. `CAVEMAN MODE ACTIVE`) does not apply to commit messages, MR/PR titles and descriptions, comments, or reviews -- these are always written in full prose

### Fixed

Expand Down
4 changes: 1 addition & 3 deletions skills/system/gh/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,9 +129,7 @@ This applies to **every** piece of content the agent creates, regardless of leng

These rules apply to every issue title and description, pull request title and description, comment, review, and commit message you write.

**Write in plain, professional prose.** Issue and pull request titles and descriptions — and commit messages — must always be written in normal, complete, well-structured English: full sentences, articles, and proper markdown. They are durable, outward-facing documents that other people read and that GitHub renders in its UI; compression hurts readability and looks unprofessional.

This rule **overrides any active terse output style for the duration of writing these artifacts.** A session-level style may inject a per-turn reminder such as `CAVEMAN MODE ACTIVE` (drop articles, fragments OK, short synonyms). That reminder applies to your conversational replies, not to the artifacts. When you compose an issue/PR title or body, a comment, a review, or a commit message, ignore that reminder for that block of text and write full prose; resume the terse conversational style for your surrounding chat replies. Do not run any command to toggle the style off — just write the artifact in plain prose regardless of what reminder is present.
**Write in plain, professional prose.** Issue and pull request titles and descriptions, comments and reviews, and commit messages must always be written in normal, complete, well-structured English: full sentences, articles, and proper markdown. They are durable, outward-facing documents that other people read and that GitHub renders in its UI; compression hurts readability and looks unprofessional. This rule **overrides any active terse output style for the duration of writing these artifacts.** A session-level style may inject a per-turn reminder such as `CAVEMAN MODE ACTIVE` (drop articles, fragments OK, short synonyms); that reminder applies to your conversational replies, not to the artifacts. When you compose an issue/PR title or body, a comment, a review, or a commit message, write full prose regardless of the active style, then resume the terse conversational style for your surrounding chat replies. Do not run any command to toggle the style off; just write the artifact in plain prose regardless of what reminder is present.

**Use the full path for cross-project references.** When you reference an issue or pull request that lives in a _different_ repository than the one you are writing in, use the full `owner/repo#123` form rather than a bare `#123`. A bare `#123` (or a short form) only resolves within the same repository and will not render as a link from another repository. Apply this in prose and in footers alike (`Closes:`, `Refs:`). For example, to reference the platform-team board from a code repository, write `sparkfabrik-innovation-team/board#4379`, never a bare `board#4379` or `#4379`. Within the same repository, a bare `#123` is correct and renders as a link.

Expand Down
4 changes: 1 addition & 3 deletions skills/system/glab/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,9 +140,7 @@ This rule applies **only to written content** (descriptions, comments, closing k

### Write in plain, professional prose

Issue and merge request titles and descriptions — and commit messages — must always be written in normal, complete, well-structured English: full sentences, articles, and proper markdown. They are durable, outward-facing documents that other people read and that GitLab renders in its UI; compression hurts readability and looks unprofessional.

This rule **overrides any active terse output style for the duration of writing these artifacts.** A session-level style may inject a per-turn reminder such as `CAVEMAN MODE ACTIVE` (drop articles, fragments OK, short synonyms). That reminder applies to your conversational replies, not to the artifacts. When you compose an issue/MR title or body, a comment, a note, or a commit message, ignore that reminder for that block of text and write full prose; resume the terse conversational style for your surrounding chat replies. Do not run any command to toggle the style off — just write the artifact in plain prose regardless of what reminder is present.
Issue and merge request titles and descriptions, comments and notes, and commit messages must always be written in normal, complete, well-structured English: full sentences, articles, and proper markdown. They are durable, outward-facing documents that other people read and that GitLab renders in its UI; compression hurts readability and looks unprofessional. This rule **overrides any active terse output style for the duration of writing these artifacts.** A session-level style may inject a per-turn reminder such as `CAVEMAN MODE ACTIVE` (drop articles, fragments OK, short synonyms); that reminder applies to your conversational replies, not to the artifacts. When you compose an issue/MR title or body, a comment, a note, or a commit message, write full prose regardless of the active style, then resume the terse conversational style for your surrounding chat replies. Do not run any command to toggle the style off; just write the artifact in plain prose regardless of what reminder is present.

### Avoid AI-slop writing tells

Expand Down
9 changes: 9 additions & 0 deletions skills/system/sf-commit-convention/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,15 @@ Example: `Assisted-by: opencode/github-copilot/claude-opus-4.6`
Same conventional commit format as the subject line. The issue reference goes in the
MR/PR description body, never in the title.

## Write in plain prose, not caveman

Commit messages (subject and body) and MR/PR titles are durable, outward-facing
artifacts: write them in normal, complete English. An active terse output style
overrides nothing here. A session-level reminder such as `CAVEMAN MODE ACTIVE`
(drop articles, fragments OK, short synonyms) applies to your conversational
replies, not to these artifacts. Write the commit and title in full prose
regardless of the active style; do not run any command to toggle the style off.

## Quick Example

```bash
Expand Down
Loading