Skip to content
Automation
Command

/update-readme

Update README documentation and push changes to GitHub.

From plugin
claude-scholar
5.1k65 skills6 agents65 commands5 hooks
Install
> /plugin marketplace add Galaxy-Dawn/claude-scholar
> /plugin install claude-scholar@claude-scholar

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/update-readme

Context preview

What this command does when you run it.

Update README documentation and push changes to GitHub.

Command definition

update-readme.md
description: Update README documentation and push changes to GitHub.

Update README

Update README.md file with latest project information and push to GitHub.

Instructions

1. **Analyze Current State**

  • Read existing README.md
  • Check recent code changes (git log)
  • Identify documentation gaps

2. **Determine Updates Needed** Check for:

  • New features added
  • Configuration changes
  • Dependencies updated
  • Installation instructions
  • Usage examples
  • API changes

3. **Propose README Updates** Show sections that need updating:

   Proposed changes:
   - [ ] Update Installation section (new dependencies)
   - [ ] Add usage example for feature X
   - [ ] Update API documentation
   - [ ] Fix broken links

4. **Update README**

  • Apply proposed changes
  • Maintain markdown formatting
  • Keep language consistent (中文/English)
  • Preserve structure

5. **Commit and Push**

  • Run `/update-github` with `docs(readme):` type
  • Example commit: `docs(readme): 更新 README 文档`

Example Usage

User: /update-readme

1. Analyzing repository state...

Recent changes:
- feat(data): 添加新的数据加载器
- fix(model): 修复训练时的内存泄漏
- chore: 更新依赖到 v2.0.0

2. Checking README.md...

Current README sections:
- Installation
- Usage
- API Reference
- Contributing

3. Proposed updates:
   [ ] Installation - 添加新的依赖说明
   [ ] Usage - 添加数据加载器示例
   [ ] API Reference - 更新模型接口文档

4. Applying updates...

   Updating Installation:
   + pip install torch>=2.0.0
   + pip install transformers>=4.30.0

   Adding usage example:
   ## 数据加载示例
   ```python
   from data import DataLoader
   loader = DataLoader(batch_size=32)

5. Review changes before committing... [Show diff]

6. Proceed with commit? > yes

7. Committing with: docs(readme): 更新 README 文档 Co-Authored-By: Claude <noreply@anthropic.com>

✅ README updated and pushed to GitHub!


## README Structure Template

When updating README, follow this structure:

```markdown
# 项目名称

简短描述项目用途。

## 安装

### 依赖要求
- Python >= 3.8
- uv 或 pip

### 安装步骤
```bash
uv sync

使用

基本用法

# 示例代码

配置

说明配置文件位置和格式。

API 文档

主要接口说明。

开发

运行测试

pytest

代码规范

  • 遵循 PEP 8
  • 使用 mypy 进行类型检查
  • 使用 ruff 进行 linting

贡献

欢迎提交 Pull Request。

许可证

MIT License


## Arguments

$ARGUMENTS can be:
- `--full` - Complete README rewrite
- `--quick` - Only update critical sections (installation, usage)
- `<section>` - Update specific section only

## Integration

After updating README, this command automatically invokes `/update-github` with `docs(readme):` commit type.
Read more
Ships withclaude-scholar

Semi-automated research assistant for academic research and software development. Supports Claude Code, Codex CLI, Kimi Code CLI, and OpenCode across ideation, coding, experiments, writing, and publication.

Get the whole plugin