drevendev/beautifulrepo

Audit how a local repository presents itself to readers using local, read-only Python checks and agent-guided checklists. Model-backed agent sessions may transfer repository context to the configured provider. Checks the README, license and contribution entry points, repository-owned Markdown links, local HTML links and section anchors, and the first-success path, then returns prioritized findings with evidence and the smallest fix for each. Use when asked to review, audit or assess a repository's README, documentation entry points or onboarding, or why newcomers struggle with a repository. Do not use for code review, security or secret scanning, live link checking, or to edit files.

Draft evidence-linked, clearly unpublished release notes from a local Git checkout using BeautifulRepo's read-only history inventory and release-note template. Use when asked to draft release notes, summarize changes since a tag or commit, or prepare a changelog from repository history. Do not use to publish releases, create tags, claim software shipped, verify builds, or perform unrelated code review.

Propose evidence-led README and newcomer-onboarding improvements for a local repository, with exact file/diff previews and approval before edits. Use when asked to rewrite, improve, or fix a repository README, installation or first-success instructions. Do not use for code review, a read-only audit alone, creating visual assets, publishing releases, or making unapproved changes.

Review a repository's licensing, contribution, security and conduct promises without inventing contacts or committing policies; propose an approved diff. Use when asked to improve SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, licensing guidance or reporting trust surfaces. Do not use for generic code review, automatic licence selection, private incident investigation or publishing unapproved policies.