Repository navigation
Allow added specifics and rework the After examples - #331
Merged
Merged
Conversation
Drop the ban on adding a fact that is not in the source. Where the text is generic, the skill now adds a specific detail it knows to be true. It still keeps every claim the original made, and a lost or changed claim is still an error. Patterns 14 and 17 follow the same change, and the README says the same. Rework 11 After examples in SKILL.md and one in the README. Several were vaguer than the text they replaced, used phrases from the skill's own watch lists, or changed a stated fact. Pattern 26's After now leads with the decision, as its rule says. SKILL.md goes from 5,298 to 5,233 words. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc
blader
changed the base branch from
clarify-skill-and-readme-wording
to
main
November 10, 2026 01:19
This was referenced Nov 10, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Specific detail is much of what makes writing read like a person wrote it. Since 2.9.0 (#189) the skill has forbidden adding any fact that is not in the source. That rule came from #187, which reported that the skill's examples added details. The report showed those details were absent from the Before text. It did not show they were false.
The ban had two costs. Rewrites stayed generic where a concrete detail would have helped. And many After examples contradicted the rule or ended up vaguer than the text they replaced.
What changed
The rule. The skill may now add a specific detail it knows to be true. It must still keep every claim the original made.
Step 2 keeps one sentence from the old rule: "If a sentence needs a detail you do not have, ask for it or write a simpler sentence." The README's "It does not make things up" paragraph now states the new behavior.
The After examples. 11 change in
SKILL.mdand one in the README.The Haolai River detail is checked against its Wikipedia article. The pattern 17 example about a New York Times interview is the one #189 removed; it describes an unnamed, made-up person.
What to decide
Validation
python3 scripts/validate-package.py,npx --yes skills@1.5.20 add . --list, andclaude plugin validate .pass.SKILL.mdgoes from 5,298 to 5,233 words. This builds on #330, which is merged.To check it, read the diff of
SKILL.md: five rule lines and eleven After examples.🤖 Generated with Claude Code
https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc