[alanhoff]

Summary

• rebuild the README around plain-language value, fit, installation, and first use
• add a custom checked-progress hero image
• keep the install contract test aligned with the approved presentation

Validation

• ruff check --no-cache src skill/scripts tests
• python3 -m unittest discover -s tests -v (67/67)
• python3 -m compileall -q src skill/scripts tests
• independent visual score: 85/100 vs 44/100 baseline (93.18% gain)

[Copilot]

🟢 Approval recommended

The README updates are consistent with existing repo artifacts (including the hero image and compose configuration), and the contract test change correctly enforces the new approved install-section format.

Pull request overview

This PR rewrites the repository README to be more approachable for non-programmers (value/fit/first use), adds a new hero image, and updates the contract test to keep the “install in one prompt” presentation locked to the approved README format.

Changes:

• Redesigned README.md structure and wording (new hero image, clearer “fit”, “first task”, FAQ, and reference details).
• Updated the install section format to a fenced text code block under the heading “Install in one prompt”.
• Adjusted the install-surface contract test to match the new README heading and code-block formatting.

File summaries

File	Description
README.md	Plain-language README redesign, new hero image reference, and updated install/usage presentation.
tests/test_contract.py	Updates the README “install prompt” contract assertions to match the new heading and fenced code block.

Review details

• Files reviewed: 2/3 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.