About github-release-assistant
A skill for generating English and Chinese README files from repository information and a small configuration file. It guides review and, when requested, a confirmed Git commit and push.
Key features
- 01Generate English and Chinese READMEs
- 02Collect facts from project files
- 03Request missing project details
- 04Review and refine the diff
- 05Confirm before Git commit and push
Use cases
- 01Create bilingual README files for a repository
- 02Fill gaps in project documentation from repository facts
- 03Prepare documentation changes for a reviewed Git commit
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ zhanlincui/ agent-skills-hunter --skill github-release-assistantAfter installing, type/github-release-assistantin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/readme_template_en.mdreadme_template_zh.mdrelease_config.example.jsonreferences/readme_outline.mdredmax_style.mdscripts/generate_release_readme.pyDetails
From the project READMEGitHub Release Assistant
Overview
Generate polished README files in English and Chinese using repo facts plus a small config file, following a concise “Redmax-style” layout. Produce README.md + README.zh.md, then optionally guide a clean git commit and push.
Workflow
- Collect repo facts from
config.json,README.md,PROJECT_STRUCTURE.md,requirements*.txt, anddocs/. - Ask for missing details or have the user fill
release_assistant.json(seeassets/release_config.example.json). - Run the generator script to write README files.
- Review the diff with the user and refine content if needed.
- If requested, stage/commit/push changes with explicit confirmation.
Quick Start
- Create or edit
release_assistant.jsonin the repo root (optional but recommended). - Run:
python3 /Users/cuizhanlin/.codex/skills/github-release-assistant/scripts/generate_release_readme.py --project-root <repo> --language both --overwrite - Verify
README.mdandREADME.zh.md.
Git Workflow (Commit + Push)
- Run
git statusandgit diffto show changes. - Ask for confirmation before
git add,git commit, andgit push. - Propose a concise commit message (e.g.,
docs: add bilingual README), and wait for approval.
Resources
- Script:
scripts/generate_release_readme.py. - Templates:
assets/readme_template_en.md,assets/readme_template_zh.md. - Config example:
assets/release_config.example.json. - Style cues:
references/redmax_style.md. - Outline guide:
references/readme_outline.md.
Comments
Markdown supported