Repository navigation
This release teaches the skill your style: it learns from what you keep, edit and delete, on your machine.
Added
scripts/learn.py: the skill learns each user's style. Every choice it makes (sections, length, heading emoji, banner style, palette, profile archetype, page theme) is an arm of a contextual bandit, with the mode, project kind and language as context. Rewards come from the user's edits:snapshotrecords what was generated, andobservescores what survived (a deleted section, a regenerated banner or a README cut by more than a quarter counts as a rejection).suggestranks options by posterior mean and picks the best one, using Thompson sampling only to choose among options tied for best, and keeps the skill's default until there is evidence. Older feedback decays, so tastes can change. Stated preferences (prefer "never use emoji in headings") are kept as rules. Data stays in~/.readme-forge(no README text, no network);show,off,onandresetcontrol it. A missing or moved README, a corrupted data file or snapshot, and a bad--repopath never teach it anything wrong. Both SKILL.md files run the loop, and 28 unit tests cover it.- Brand icons in
.github/assets/brand/: a README page with a check mark on a violet-to-cyan tile, as a vectoricon.svg, PNGs at 1024, 512, 400 and 240 px, and a multi-sizefavicon.ico. It stays readable down to 16 px. The README hero card shows the mark. - A form for the Show and tell discussion category, for sharing READMEs made with the skill.
gallery/gallery.jsonand the gallery website: every banner style, full README design, profile style, button and footer, and the before/after demo, with the command that makes each one. Anyone can add their README by pull request (gallery/README.md);tests/test_gallery.pychecks every entry.
Changed
- Releases are cut from tags like
v1.4.0only. A movingv1tag now follows the latest 1.x release, souses: tanmayai23/README-Editor-skill@v1in the README and the Action docs resolves; until now nov1tag existed. The release job moves it after publishing. check_links.pyhas a new status,UNVERIFIED, for hosts that block bots (npm, LinkedIn and others) and GitHub pages that need a login, such as/stargazers. It is reported but doesn't fail the run. Exit code 1 still meansBROKENorWIDGET-ERROR.
Fixed
- The readme-forge-design skill description was 1051 characters, over the 1024 that claude.ai accepts, so uploading
readme-forge-design.zipfailed. It is now 1009, andtests/test_skills.pychecks the name and description limits of both skills. - Files with a UTF-8 BOM or in UTF-16, common on Windows, are read correctly by
analyze_repo.pyandscore_readme.py. Before, apackage.jsonorpyproject.tomlwith a BOM lost every fact, and a README with a BOM scored 8/100 with "no title" (#24). analyze_repo.pyskips files that.gitignoreexcludes, so generated or vendored code no longer decides the primary language or adds env vars (#26).score_readme.pybuilds heading anchors the way GitHub does: backticks and link syntax are removed, and duplicate headings get-1,-2(#27). It also stops reporting working relative links as missing: URL-encoded paths, paths from the repo root (/docs/...) and example links inside code blocks (#28).check_links.pychecks reference-style links ([id]: url), including badges, reads URLs with parentheses in full, and skips code (#29). It follows 307 and 308 redirects on every Python version (#30).- Animated banners now stop when the OS asks for reduced motion. The orbit, terminal, bold, spotlight and ribbon styles used SMIL, which CSS can't pause; they now use CSS animations (#32).
make_banner.pyaccepts--accentas#RGBor#RRGGBBand rejects anything else with a clear message instead of crashing. Chinese, Japanese and Korean titles and long subtitles shrink, wrap or end with an ellipsis to stay inside the banner (#33).analyze_repo.pyno longer crashes on a symlink to missing model weights, and it reads env vars in files such aslatest.pywhose names contain "test" (#34).