Skills
.Work. You
Rest

normalize-skills

Community

Audit skill health and backfill icons.

Software Engineering#audit#skills#marketplace#frontmatter#symlink#maintainer#icon-backfill
Authoralecs5am
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill keeps the skill bundle and landing marketplace visually coherent by auditing every .agents/skills/*/SKILL.md for frontmatter correctness, kebab-case name, description length, and valid namespace, and by checking for the corresponding .claude/skills/<slug> symlinks.

Core Features & Use Cases

  • Enumerates skills and validates frontmatter alignment, including slug-name matching and description length.
  • Verifies that a .claude/skills/<slug> symlink resolves to ../../.agents/skills/<slug>, and flags drift or dangling links.
  • Backfills landing icons by coordinating with landing/scripts/gen-skill-icons.sh and landing/scripts/build-skill-icons.py to ensure each missing slug has a webp tile, while honoring the append-only workflow.
  • Proposes fixes or symlink updates when skill names are renamed or drift is detected, without mutating SKILL.md silently.

Quick Start

Run the audit to identify frontmatter drift and missing icons, and backfill icons for any newly added or renamed slugs.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: normalize-skills
Download link: https://github.com/alecs5am/ralphy/archive/main.zip#normalize-skills

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.