본문으로 건너뛰기
cccskills
무료GitHub에 공개

readme-updater

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구PostgreSQL
설치 방법 보기

포함된 파일(2)

  • SKILL.md6.0 KB
  • README.md827 B

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

# 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

# You add: npm install stripe

# I suggest:
## Installation

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

Environment Variables

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

# 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

npm test

### Update Examples

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

After (API changed):

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:

## 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

# 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

# Project Name

Brief description

## Features
- Feature 1
- Feature 2

## Installation
```bash
npm install

Usage

// 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

/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

# .github/workflows/docs.yml
- name: Update README
  run: |
    # Skill suggests updates based on changes
    # Review and commit

Customization

Add company-specific README standards:

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

# Edit to add:
# - Company README template
# - Required sections
# - Badge standards

Related Tools

  • 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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Auto-generate API documentation from code and comments. Use when API endpoints change, or user mentions API docs. Creates OpenAPI/Swagger specs from code. Triggers on API file changes, documentation requests, endpoint additions.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

Automatic code quality and best practices analysis. Use proactively when files are modified, saved, or committed. Analyzes code style, patterns, potential bugs, and security basics. Triggers on file changes, git diff, code edits, quality mentions.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

Check dependencies for known vulnerabilities using npm audit, pip-audit, etc. Use when package.json or requirements.txt changes, or before deployments. Alerts on vulnerable dependencies. Triggers on dependency file changes, deployment prep, security mentions.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

Generate conventional commit messages automatically. Use when user runs git commit, stages changes, or asks for commit message help. Analyzes git diff to create clear, descriptive conventional commit messages. Triggers on git commit, staged changes, commit message requests.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

Detect exposed secrets, API keys, credentials, and tokens in code. Use before commits, on file saves, or when security is mentioned. Prevents accidental secret exposure. Triggers on file changes, git commits, security checks, .env file modifications.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

Continuous security vulnerability scanning for OWASP Top 10, common vulnerabilities, and insecure patterns. Use when reviewing code, before deployments, or on file changes. Scans for SQL injection, XSS, secrets exposure, auth issues. Triggers on file changes, security mentions, deployment prep.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

alirezarezvani/claude-code-tresor7822026년 7월 3일 업데이트

alirezarezvani의 스킬 모두 보기

이 스킬의 문제 신고