skills-readme-updater

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

This skill should be used after creating or modifying skills to update the main README.md file. It scans all skills in ~/.claude/skills/, extracts metadata from SKILL.md files, and regenerates the README with categorized skill listings. Triggers on requests mentioning "update skills readme", "refresh skills list", or after adding new skills.

3installs

Sourceoldwinter/skills

Added on2026-02-08

NPX Install

npx skill4agent add oldwinter/skills skills-readme-updater

SKILL.md Content

View Translation Comparison →

Skills README Updater

Automatically scan and update the skills README.md when skills are added, modified, or removed.

Usage

After adding or modifying a skill, run the update script:

bash

python3 ~/.claude/skills/skills-readme-updater/scripts/update_readme.py

The script will:

Scan all subdirectories in
```
~/.claude/skills/
```
Parse YAML frontmatter from each
```
SKILL.md
```
Categorize skills based on predefined categories
Generate an updated
```
README.md
```
with:
- Categorized skill tables
- Directory structure
- Usage instructions
- Timestamp

Categories

Skills are organized into these categories:

Category	Skills
云基础设施	aws-cli, aws-cost-explorer, eksctl
Kubernetes & GitOps	kubectl, argocd-cli, kargo-cli, sync-to-prod
代码仓库	github-cli, gitlab-cli, changelog-generator
开发工具	justfile, skill-creator, skills-readme-updater
内容处理	humanizer-zh, obsidian-dashboard

To add a new category or reassign skills, edit the

CATEGORIES

dict in

scripts/update_readme.py

.

Workflow: Adding a New Skill

Create the skill using
```
skill-creator
```
Edit
```
SKILL.md
```
with proper metadata

Run the README updater: