mcpField
S
skills-readme-updater

skills-readme-updater

github.com/oldwinterAgent workflows1041 installsUpdated 1w ago
Repository

About skills-readme-updater

A script-based skill that refreshes the skills README.md after skills are added, changed, or removed. It scans SKILL.md metadata, groups skills into predefined categories, and generates categorized tables, directory details, usage instructions, and a timestamp.

Key features

  1. 01Scans skill subdirectories
  2. 02Parses SKILL.md YAML frontmatter
  3. 03Groups skills into predefined categories
  4. 04Generates README tables and details
  5. 05Includes usage instructions and timestamp

Use cases

  1. 01Refreshing the skills index after adding a skill
  2. 02Rebuilding README listings after skill edits
  3. 03Updating categories and directory documentation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oldwinter/skills --skill skills-readme-updater

After installing, type/skills-readme-updaterin Claude Code to confirm it loaded.

Bundled filesscripts/update_readme.py

Details

From the project README

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:

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

The script will:

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

Categories

Skills are organized into these categories:

CategorySkills
云基础设施aws-cli, aws-cost-explorer, eksctl
Kubernetes & GitOpskubectl, 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

  1. Create the skill using skill-creator
  2. Edit SKILL.md with proper metadata
  3. Run the README updater: 
    python3 ~/.claude/skills/skills-readme-updater/scripts/update_readme.py
  4. Verify the README was updated correctly

Comments

Markdown supported