Repository navigation
docs(docs-hygiene): reword write-for-humans away from pstack technical-writing #9780
Closed as not planned
Description
Parent: #7052 (owner decision 2026-10-13: one PR per plugin).
Problem
A copy check during #7009 flagged text in this plugin that shares word runs or one-to-one structure with an upstream source. The repository's rule is our own words, with credit only on docs/upstream/ pages. Line numbers from the filing are stale; locate the passage by the finding.
| Local file | Upstream (repo@sha, path) | Finding |
|---|---|---|
plugins/docs-hygiene/skills/write-for-humans/SKILL.md |
cursor/plugins@12d587dfb2 pstack/skills/technical-writing/SKILL.md |
section-by-section paraphrase: four layers, three rules, Diataxis compass, mode table, no-mixing list, rhythm, UI-strings exclusion |
Fix
Confirm each finding with fingerprint.mjs compare first. If it does not fire, record that in the PR and change nothing. If it fires, rewrite the passage in a new structure with this repository's own examples, keeping every directive and eval expectation. Make sure the upstream source has a credit row on docs/upstream/cursor-pstack.md.
Done when
-
gh api -H 'Accept: application/vnd.github.raw' 'repos/cursor/plugins/contents/pstack/skills/technical-writing/SKILL.md?ref=12d587dfb2' > /tmp/upstream-docs-hygiene-0.mdthennode plugins/attribution/skills/audit/scripts/fingerprint.mjs compare --local plugins/docs-hygiene/skills/write-for-humans/SKILL.md --source /tmp/upstream-docs-hygiene-0.md | jq .separation.firedprintsfalse. - The PR body lists each passage with its before and after
longest_span_wordsandcontainment. -
scripts/check-changelog-fragments.shpasses.
Activity
github-actions commentedon Oct 24, 2026
Proposed work class: work-class: scoped
Basis: automated intake triage; the lanes App applied this class.
Size: Small
Complexity: Medium
Uncertainty: Knowable
Flags: none
Understood: confirm with the fingerprint compare tool whether write-for-humans/SKILL.md still overlaps the upstream pstack technical-writing skill. If it does, reword it in this repository's own structure and examples, keep every directive and eval expectation, and make sure docs/upstream/cursor-pstack.md has a credit row. If the check doesn't fire, change nothing and note that in the PR. The done-when items are clear. Nothing is missing. I found no likely duplicates beyond the parent #7052.
Automated triage, applied by the lanes App.
melodic-automation-lanes commentedon Oct 24, 2026
The work-resolve-issue run that
agent-readystarted ended over 3 hours ago with no report and no pull request. work-unblock removed and addedagent-readyback to start a fresh run on main's workflow files. It does this once per version of those files, so if this run fails the same way, a person looks at it.melodic-automation-lanes commentedon Oct 24, 2026
The work-resolve-issue lane stopped partway through this issue and needs a person.
Why, in the run's own words:
What the run says it did not do:
Run: https://github.com/melodic-software/claude-code-plugins/actions/runs/40131625997
To retry, remove
needs-humanand addagent-readyagain.kyle-sexton commentedon Oct 25, 2026
Closing as not planned: the copy check this issue's Fix starts with does not fire, and its rule for that case is "record that ... and change nothing".
Evidence, run 2026-10-25 against main at 5e70951:
fingerprint.mjs compare --local plugins/docs-hygiene/skills/write-for-humans/SKILL.md --source <cursor/plugins@12d587dfb2:pstack/skills/technical-writing/SKILL.md, fetched raw>returned{"fired":false,"rule":"containment>=0.3||span>=15","longest_span_words":0,"containment":0,"jaccard":0}.The upstream source already has a credit row in
docs/upstream/cursor-pstack.md, so the Fix's other condition holds too.The issue lane could not do this itself: its run stopped because it cannot run node or gh (lane outcome on #9786, run 40213739706).
Reopen it if a later check finds a structural copy the word-run compare does not measure.