Agent skill

Readme Updater

by alirezarezvani in alirezarezvani/claude-code-tresor

Keep README files current with project changes. An agent skill from alirezarezvani/claude-code-tresor.

MITAuto-check passedDevelopment

Install Readme Updater

skills CLI
$ npx skills add alirezarezvani/claude-code-tresor --skill readme-updater -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-code-tresor readme-updater --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-tresor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/documentation/readme-updater .claude/skills/readme-updater && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
readme-updater
GitHub stars
777
Token cost
~1.5k tokens
SKILL.md length
259 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Keep README files current with project changes. An agent skill from alirezarezvani/claude-code-tresor.

  • Works in 4 steps: I detect changes → I suggest README updates → For full docs → Invoke @docs-writer… → …
  • Project structure changes
  • SKILL.md covers When I Activate, What I Update, Examples and Environment Variables, plus 15 more sections
  • Calls npm, git and docker-compose; needs STRIPE_SECRET_KEY and API_KEY

What it does

Readme Updater is an agent skill from alirezarezvani/claude-code-tresor. Keep README files current with project changes. Use when project structure changes, features added, or setup instructions modified. Suggests README updates based on code changes. Triggers on significant project changes, new features, dependency changes.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Development, covering Technical documentation. It works with npm and Stripe. The repository describes itself as: A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow. The licence is MIT.

When your agent uses it

  • Project structure changes
  • Setup instructions modified
  • Significant project changes
  • Dependency changes

Example prompts

  • “/readme-updater”

Requirements

  • Node.js
  • Docker
  • A credential in STRIPE_SECRET_KEY
  • A credential in API_KEY
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. I detect changes
  2. I suggest README updates
  3. For full docs → Invoke @docs-writer sub-agent
  4. Sub-agent creates complete documentation

What it can do on your machine

Read from SKILL.md and the folder at commit 4b68050. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • git
    • docker-compose

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • STRIPE_SECRET_KEY
    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Readme Updater loads about 1.5k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-code-tresor at commit 4b68050, republished under its MIT licence (© alirezarezvani). 259 words, ~1,523 tokens.

Download SKILL.mdSave it as .claude/skills/readme-updater/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
readme-updater
description
Keep README files current with project changes. Use when project structure changes, features added, or setup instructions modified. Suggests README updates based on code changes. Triggers on significant project changes, new features, dependency changes.
allowed-tools
Read, Write, Edit, Grep

README Updater Skill

Keep your README current with project changes.

When I Activate

  • ✅ New features added
  • ✅ Project structure changes
  • ✅ Dependencies added/removed
  • ✅ Setup instructions change
  • ✅ User mentions README or documentation
  • ✅ Configuration files modified

What I Update

README Sections

Installation:

  • New dependencies
  • Setup steps
  • Prerequisites
  • Environment variables

Features:

  • New capabilities
  • Functionality changes
  • Feature deprecation

Usage:

  • API changes
  • New examples
  • Updated screenshots

Configuration:

  • New options
  • Environment variables
  • Config file changes

Examples

New Feature Addition
bash
# You add authentication:
git diff
# + auth.service.ts
# + login.component.tsx
# + JWT middleware

# I suggest README update:
## Features
- ✨ User authentication with JWT  # NEW
- 🔐 Role-based access control    # NEW
- User management
- Dashboard
New Dependency
bash
# You add: npm install stripe

# I suggest:
## Installation

```bash
npm install
npm install stripe  # Added for payment processing

Environment Variables

bash
STRIPE_SECRET_KEY=your_stripe_key  # Required for payments

### Setup Instructions

```bash
# You modify docker-compose.yml

# I update README:
## Development Setup

```bash
# 1. Clone repository
git clone [url]

# 2. Install dependencies
npm install

# 3. Start services (UPDATED)
docker-compose up -d  # Now includes Redis cache

# 4. Run migrations
npm run migrate

## Detection Logic

### Change Analysis

I detect these changes automatically:
- **package.json** → Update dependencies section
- **New routes** → Update API documentation
- **.env.example** → Update environment variables
- **docker-compose.yml** → Update setup instructions
- **New features** → Update features list

### Section Mapping

```yaml
Code Change → README Section:
  - New API endpoint → Usage / API Reference
  - New dependency → Installation
  - New env var → Configuration
  - New feature → Features list
  - Architecture change → Architecture section

Intelligent Updates

Keep Structure

I maintain your README structure:

  • Preserve emoji style
  • Keep formatting consistent
  • Maintain tone and voice
  • Respect existing organization
Add Missing Sections
markdown
# Suggested additions:

## Prerequisites
- Node.js 18+
- Docker (for development)
- PostgreSQL 14+

## Environment Variables
```bash
DATABASE_URL=postgresql://localhost/mydb
API_KEY=your_api_key

Testing

bash
npm test

### Update Examples

```markdown
# Before:
```javascript
const result = api.getUsers();

After (API changed):

javascript
const result = await api.getUsers({ page: 1, limit: 10 });

## Version Compatibility

I track version-specific documentation:

```markdown
## Requirements

- Node.js 18+ (updated from 16+)
- TypeScript 5.0+ (new requirement)
- React 18+ (unchanged)

Changelog Integration

I can sync with CHANGELOG.md:

markdown
## Recent Changes

See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

### Latest (v2.1.0)
- ✨ Added user authentication
- 🔧 Fixed memory leak in data processing
- 📝 Updated API documentation

Screenshot Management

markdown
# I suggest when UI changes:
## Screenshots

![Dashboard](screenshots/dashboard.png)
*Updated: 2025-10-24 - New authentication panel*

![User Profile](screenshots/profile.png)
*New feature - user profile management*

Relationship with @docs-writer

Me (Skill): Keep README current with code changes @docs-writer (Sub-Agent): Comprehensive documentation strategy

Workflow
  1. I detect changes
  2. I suggest README updates
  3. For full docs → Invoke @docs-writer sub-agent
  4. Sub-agent creates complete documentation

Sandboxing Compatibility

Works without sandboxing: ✅ Yes Works with sandboxing: ✅ Yes

  • Filesystem: Writes to README.md
  • Network: None required
  • Configuration: None required

Best Practices

  1. Keep it current - Update README with every feature
  2. Be specific - Include version numbers, prerequisites
  3. Add examples - Show actual usage, not just API
  4. Include troubleshooting - Common issues and solutions
  5. Badge status - Keep build/coverage badges current

README Templates

Basic Structure
markdown
# Project Name

Brief description

## Features
- Feature 1
- Feature 2

## Installation
```bash
npm install

Usage

javascript
// Example

Configuration

Environment variables needed

Contributing

How to contribute

License

MIT


### Comprehensive Structure

```markdown
# Project Name
> Tagline

[Badges]

## Table of Contents
- Features
- Installation
- Usage
- API Reference
- Configuration
- Development
- Testing
- Deployment
- Contributing
- License

[Sections with detailed content]

Integration

With /docs-gen Command
bash
/docs-gen --format markdown

# Generates:
# 1. README.md (via me)
# 2. Full documentation site (via @docs-writer)
# 3. API reference (via api-documenter)
With CI/CD
yaml
# .github/workflows/docs.yml
- name: Update README
  run: |
    # Skill suggests updates based on changes
    # Review and commit

Customization

Add company-specific README standards:

bash
cp -r ~/.claude/skills/documentation/readme-updater \
      ~/.claude/skills/documentation/company-readme-updater

# Edit to add:
# - Company README template
# - Required sections
# - Badge standards
  • api-documenter skill: API documentation
  • @docs-writer sub-agent: Comprehensive docs
  • git-commit-helper skill: Commit messages for updates
  • /docs-gen command: Full documentation generation

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/documentation/readme-updater of alirezarezvani/claude-code-tresor.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 4b68050

Compare with similar skills

Readme Updater next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Readme Updater compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readme Updater this skillalirezarezvani/claude-code-tresor777—~1.5kAutomated safety check: PassMIT
Get API Docs with chubandrewyng/context-hub14k1 repos~775Automated safety check: PassMIT
Update .NET Supported OS Matrixdotnet/core22k—~4.1kAutomated safety check: PassMIT
Ccb GitHubSeemSeam/claude_codex_bridge3.6k—~4.9kAutomated safety check: PassCustom licence
README Badges and Headersjal-co/shieldcn918—~4.3kAutomated safety check: PassMIT
Release Managerukorvl/lightweight-charts-react-components136—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Get API Docs with chub

    andrewyng/context-hub

    Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.

    14k GitHub starsUsed in 1 repo~775 tokens
    DevelopmentAuto-check passed
  • Official

    Audits and updates the supported-os.json files for .NET releases, checking them against upstream lifecycle data and regenerating the markdown with the release-notes tool.

    22k GitHub stars~4.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Ccb GitHub

    SeemSeam/claude_codex_bridge

    Maintain this CCB project's GitHub-facing release and npm publication surface.

    3.6k GitHub stars~4.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Adds shadcn/ui-styled README badges, badge groups, download charts, header banners and sponsor or contributor grids using the shieldcn service.

    918 GitHub stars~4.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Manager

    ukorvl/lightweight-charts-react-components

    Prepare or finalize semver releases for this repository. An agent skill from ukorvl/lightweight-charts-react-components.

    136 GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Verify New Sample PR

    pnp/sp-dev-fx-aces

    Verify a "new sample" PR in pnp/sp-dev-fx-aces builds successfully, then produce a deployment + testing checklist from the sample README so it can be manually deployed and tested before merging.

    139 GitHub stars~2k tokensUpdated 11 days ago
    DevelopmentAuto-check passed

More from alirezarezvani/claude-code-tresor

  • API Documenter

    alirezarezvani/claude-code-tresor

    Auto-generate API documentation from code and comments. An agent skill from alirezarezvani/claude-code-tresor.

    777 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Code Reviewer

    alirezarezvani/claude-code-tresor

    Automatic code quality and best practices analysis. An agent skill from alirezarezvani/claude-code-tresor.

    777 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check passed
  • Dependency Auditor

    alirezarezvani/claude-code-tresor

    Check dependencies for known vulnerabilities using npm audit, pip-audit, etc.

    777 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check: notes
  • Git Commit Helper

    alirezarezvani/claude-code-tresor

    Generate conventional commit messages automatically. An agent skill from alirezarezvani/claude-code-tresor.

    777 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes
  • Test Generator

    alirezarezvani/claude-code-tresor

    Automatically suggest tests for new functions and components.

    777 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Secret Scanner

    alirezarezvani/claude-code-tresor

    Detect exposed secrets, API keys, credentials, and tokens in code.

    777 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check: warnings

Works with

Categories

Questions about Readme Updater

What does Readme Updater do?

Keep README files current with project changes. An agent skill from alirezarezvani/claude-code-tresor. Readme Updater is an agent skill from alirezarezvani/claude-code-tresor. Keep README files current with project changes.

When should I use Readme Updater?

Readme Updater fits situations like: project structure changes; setup instructions modified; significant project changes; dependency changes.

How do I install Readme Updater in Claude Code?

Run `npx skills add alirezarezvani/claude-code-tresor --skill readme-updater -a claude-code`. Or copy the skill folder (skills/documentation/readme-updater in alirezarezvani/claude-code-tresor) into .claude/skills/readme-updater in your project. Claude Code loads it when a task matches its description.

How do I install Readme Updater in Codex?

Run `npx skills add alirezarezvani/claude-code-tresor --skill readme-updater -a codex`. Or copy the skill folder (skills/documentation/readme-updater in alirezarezvani/claude-code-tresor) into .agents/skills/readme-updater in your project. Codex loads it when a task matches its description.

Can I use Readme Updater in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-code-tresor --skill readme-updater -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readme-updater, .gemini/skills/readme-updater, .github/skills/readme-updater and .opencode/skills/readme-updater in your project.

What does Readme Updater need to run?

Going by SKILL.md and its folder, Readme Updater needs the command-line tools its instructions call (npm, git and docker-compose) and credentials named STRIPE_SECRET_KEY and API_KEY. Our summary lists: Node.js; Docker; A credential in STRIPE_SECRET_KEY; A credential in API_KEY. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep.

Does Readme Updater access the network?

SKILL.md contains no URLs. Its commands use npm and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Readme Updater safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Readme Updater use?

Readme Updater is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Readme Updater use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Readme Updater?

Skills that share tags, products or a category with Readme Updater: Get API Docs with chub (andrewyng/context-hub, 14k stars), Update .NET Supported OS Matrix (dotnet/core, 22k stars), Ccb GitHub (SeemSeam/claude_codex_bridge, 3.6k stars) and README Badges and Headers (jal-co/shieldcn, 918 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readme Updater?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-code-tresor, which has 777 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 3, 2026.

Source: alirezarezvani/claude-code-tresor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.