Skip to content

Small changes to writing-docs skill - #2016

Merged
mscuthbert merged 5 commits into
masterfrom
writing-docs-prose
Aug 28, 2026
Merged

Small changes to writing-docs skill#2016
mscuthbert merged 5 commits into
masterfrom
writing-docs-prose

Conversation

@mscuthbert

Copy link
Copy Markdown
Member

Most of this got folded into other PRs, so just a few register changes.

Length was covered; voice was not. Adds rules for examples drawn from real
music, leading with the verb, varying sentence length, cutting throat-clearing,
and treating the house's dry humor as style rather than slippage.

Shortens the skill description from 55 words to 34 -- it loads every session.

AI-assisted (Claude)
Master's new "Examples" section already says pick examples musicians care about
and that dull docs get closed, so this branch's versions of those go.  What
survives is the four rules master does not state: lead with the verb, vary
sentence length, cut throat-clearing, and keep a joke to one sentence.

AI-assisted (Claude)
No separate Prose heading: lead-with-the-verb joins Examples, sentence length,
throat-clearing and joke length join Writing and Comment style.

AI-assisted (Claude)
@mscuthbert
mscuthbert merged commit 58bb819 into master Aug 28, 2026
6 checks passed
@mscuthbert
mscuthbert deleted the writing-docs-prose branch August 28, 2026 22:34
@coveralls

Copy link
Copy Markdown

Coverage Status

coverage: 93.34%. remained the same — writing-docs-prose into master

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants