Repository navigation
docs(skills): replace metaphor labels with plain language - #16
Merged
Merged
Conversation
Skill bodies only: "Hard gate" / "Iron law" / "Iron rule" become "Hard rule", "Iron sequence" becomes "Always in this order", the verify-before-done "Gate" section becomes "Required checks", and the "Red lines" sections become "Hard rules". Frontmatter descriptions and the SessionStart primer are untouched, so the frozen 4944-character fixed-context baseline does not move. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.
What
Replace metaphor-style labels in skill bodies with plain language. A label like "gate" / "iron" / "red line" makes the reader decode an image first; the plain word says the same thing directly, for humans and models alike.
Hard gate:Hard rule:Iron law:/Iron rule:Hard rule:Iron sequence:Always in this order:## Gate (…)/pass the gate above## Required checks (…)/pass the checks above## Red lines## Hard rulesSide effect: all five rule-opener lines now share one uniform label (
Hard rule:).Checked and deliberately kept
Verification (all after the edits)
python tests/test-plugin-metadata.py— passedbash tests/test-hooks.sh— passedtests/test-windows-hook.ps1— passed🤖 Generated with Claude Code