0.3.1: force LF, Desktop install notes, phase-2 acceptance record

[ccf]

Summary

• .gitattributes (* text=auto eol=lf) and test_tracked_text_files_use_lf: every clone is LF regardless of the host's core.autocrlf. The Claude Desktop skill loader rejects CRLF frontmatter (anthropics/claude-code #36902) and "Add from repository" is a Git clone.
• README: the Claude Desktop row leads with the repository route (works on macOS and Windows) and says to restart the app after installing or updating a plugin — the / menu can list humanize:humanize before the invocable registry has it (cf. #62485). The skill zip is the alternative for claude.ai without the Desktop app.
• docs/acceptance/v0.3/README.md: phase-2 record (Codex and Hermes installs from main, plugin upgrade 0.2.0 → 0.3.0, Desktop on both platforms with the restart caveat).
• Spec: one Post-review amendment bullet; CLAUDE.md invariant; CHANGELOG 0.3.1; version 0.3.1 in lockstep.

Test plan

• uv run pytest -q -W error → 109 passed on 3.9 and 3.13
• claude plugin validate --strict .
• CI green, Bugbot clean
• Tag v0.3.1, release with the zip, plugin update

🤖 Generated with Claude Code

https://claude.ai/code/session_01KTKYvLEVY4mStJ3iPaB1Mh

---

Note

Low Risk
Documentation, git attributes, and a CI portability test only; version bumps with no runtime skill or scanner changes.

Overview
0.3.1 is a packaging and documentation patch: no skill or scanner behavior changes.

Line endings for Claude Desktop. Adds .gitattributes (* text=auto eol=lf) so clones stay LF regardless of core.autocrlf, because the Desktop skill loader rejects CRLF in SKILL.md frontmatter when installing via “Add from repository.” test_tracked_text_files_use_lf in tests/test_portability.py fails if any tracked text file contains \r; CLAUDE.md documents the invariant.

Install docs. The README install table now leads with Claude Desktop’s repository install (macOS and Windows), requires an app restart after install or update (picker can show /humanize:humanize before it is invocable), and positions the release zip as the path for claude.ai without Desktop.

Release bookkeeping. Version 0.3.1 is bumped in lockstep across manifests, pyproject.toml, and uv.lock; CHANGELOG.md records the release; phase-2 acceptance outcomes (Codex/Hermes from main, 0.2.0→0.3.0 upgrade, Desktop on both platforms) are appended to docs/acceptance/v0.3/README.md with a matching design-doc amendment.

^{Reviewed by Cursor Bugbot for commit 85c3f25. Bugbot is set up for automated code reviews on this repo. Configure here.}