Skip to content

docs: Claude skill 'prefer-sedx-over-sed' + README refresh#6

Merged
InkyQuill merged 2 commits into
mainfrom
docs/skill-and-usage
Apr 19, 2026
Merged

docs: Claude skill 'prefer-sedx-over-sed' + README refresh#6
InkyQuill merged 2 commits into
mainfrom
docs/skill-and-usage

Conversation

@InkyQuill

Copy link
Copy Markdown
Owner

Summary

Adds a focused "when to use sedx instead of sed" Claude skill (with one-liner installer) mirroring sel's contrib/claude-skill/ pattern, plus README and docs refresh to surface it.

  • contrib/claude-skill/prefer-sedx-over-sed/SKILL.md — short, trigger-focused skill with a translation table and "when not to rewrite" guardrails.
  • contrib/claude-skill/install.sh — POSIX installer with --user / --project / --dest / --uninstall / --force, supports local-repo copy AND curl | sh remote fetch (via SEDX_SKILL_REPO / SEDX_SKILL_REF).
  • contrib/claude-skill/README.md — one-liner install instructions + pointers.
  • README — new "Claude Code integration" section linking to the installer.
  • docs/CLAUDE_SKILL.md — pointer at the top clarifying this is the long-form reference; the installable skill lives in contrib/.
  • TEST_SUITE_SUMMARY.txt — removed, described the old shell test suite replaced in Spec A.

Test plan

  • ./contrib/claude-skill/install.sh --dest /tmp/test round-trip (install + uninstall) works locally
  • cargo test, cargo clippy --all-targets -- -D warnings, cargo fmt --check green
  • After merge: verify the curl | sh one-liner works against main

Mirrors sel's claude-skill layout:
  contrib/claude-skill/prefer-sedx-over-sed/SKILL.md
  contrib/claude-skill/install.sh
  contrib/claude-skill/README.md

The skill nudges Claude to prefer sedx over GNU/BSD sed for file-editing
work whenever sedx is installed, highlighting --dry-run / automatic
backup / rollback as the safety wins. Deliberately sits alongside (not
replaces) docs/CLAUDE_SKILL.md — the former is a focused 'when to
switch' trigger, the latter is the long-form reference.
- README: new 'Claude Code integration' section with one-liner install
  for the prefer-sedx-over-sed skill, cross-links to the contrib/ files
  and the long-form docs/CLAUDE_SKILL.md reference.
- docs/CLAUDE_SKILL.md: add a pointer at the top clarifying that this is
  the long-form reference and the installable skill lives in
  contrib/claude-skill/ (single source of truth).
- TEST_SUITE_SUMMARY.txt: removed — it describes the old shell test
  suite (tests/fixtures/, tests/scripts/) that was replaced by the Rust
  integration tests in Spec A. Obsolete.
@InkyQuill InkyQuill merged commit 2c7512a into main Apr 19, 2026
13 checks 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