Skip to content

Tighten skill and README wording, polish After examples, and add "the part" to §4 - #343

Merged
blader merged 1 commit into
mainfrom
improve-skill-and-readme
Nov 19, 2026
Merged

blader merged 1 commit into
mainfrom
improve-skill-and-readme

Conversation

@blader

@blader blader commented Nov 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • Effectiveness & AI slop:
    • Adds "the part" as a stand-in tell to §4 (Add "the part" as a stand-in to §4 #338) for both staged run-ups ("The hard part is...") and unnamed placeholders ("This post is about the part that doesn't", "the part worth sharing"), while leaving literal parts alone.
    • Polishes four After examples in SKILL.md so they read more naturally and drop residual AI/academic phrasing:
      • §6 (Forced triads): Merges two choppy sentences into "The event includes talks and panels, with time for informal networking between sessions."
      • §13 (Inflated significance): Replaces "part of a wider decentralization of administrative functions in Spain" with "as part of a wider move across Spain to decentralize government work."
      • §15 (Shallow -ing phrases): Tightens "painted blue, green, and gold, colors meant to evoke..." to "painted blue, green, and gold to evoke..."
      • §25 (Writing about the document): Replaces "the O(n²) cost of naive iteration" with "the O(n²) cost of iterating through every item."
    • Fixes a missing hyphen in §26's After example ("keep this PR account-specific").
  • Concision, clarity & readability:
    • Merges the two prompt-injection paragraphs in SKILL.md into a single direct instruction.
    • Simplifies the strength-ordering sentence in SKILL.md ("The patterns are numbered strongest first, by how rarely a careful writer would use one on purpose").
    • Aligns output terminology between SKILL.md and README.md ("the first rewrite, a short list of tells that survived it, and the final rewrite").
    • Tightens phrasing across steps 1–4, Voice, File mode, §9, §10, §12, §22, §23, §26, When not to act, and README.md.

Validation

  • python3 scripts/validate-package.py passes (SKILL.md is 5,274 words, under the 5,500-word cap).
  • claude plugin validate . and npx skills add . --list pass.

@blader
blader merged commit 732e48a into main Nov 19, 2026
1 check passed
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.

1 participant