skills.rest
alecs5am
alecs5amCOMMUNITY
Explore all skills by this author →
GitHub

normalize-skills

Audit SKILL.md frontmatter and symlinks for drift.

118|12|Updated May 5, 2026
Search Tags:#audit#skills#marketplace#frontmatter#symlink#maintainer#icon-backfill
One-click install
npx skills add https://github.com/alecs5am/ralphy --skill normalize-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: normalize-skills
Source: https://github.com/alecs5am/ralphy/tree/main/.agents/skills/normalize-skills
Command: npx skills add https://github.com/alecs5am/ralphy --skill normalize-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about normalize-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit SKILL.md frontmatter for kebab-case name and description length errors?▼

You can backfill missing webp icon tiles by coordinating with landing/scripts/gen-skill-icons.sh and build-skill-icons.py. This skill identifies slugs lacking webp tiles and backfills them while honoring the append-only workflow.

How do I verify .claude/skills symlinks resolve correctly to .agents/skills?▼

To verify symlink resolution, check that each .claude/skills/<slug> symlink resolves to ../../.agents/skills/<slug>. This skill checks for dangling links and flags drift when skill names are renamed.

Does this skill mutate SKILL.md files automatically when frontmatter drift is detected?▼

No, this skill does not mutate SKILL.md files silently. It reports findings and proposes fixes or symlink updates only with explicit confirmation, ensuring safe frontmatter alignment without unauthorized changes.

What are the limitations of auditing skill namespaces and symlinks without explicit confirmation?▼

The limitation is that this skill reports frontmatter drift and dangling symlinks without mutating SKILL.md unless explicitly confirmed. It validates namespace values and symlink resolution but requires manual approval for any proposed fixes.

Related Skills

Explore More Software Engineering Skills→
akiojinakiojin
8

skill-installer

Install Codex skills into $CODEX_HOME/skills from curated sources or GitHub repositories.

Community
Advanced
cuiosscuioss
4

tools-script-executor

Execute marketplace scripts through a centralized Python proxy with notation-based invocation.

Official
Advanced
LaiTszKinLaiTszKin
4

maintain-skill-catalog

Audit and standardize skill catalog metadata, dependencies, and agent configurations.

Community
Advanced
avifeneshavifenesh
376

custom-agent-skill

Validate kebab-case agent names against length and character rules.

Community
Basic