skills.rest
kevinslin
kevinslinCOMMUNITY
Explore all skills by this author →
Website𝕏@kevins8GitHub

meta.skill-optimizer

Identify and optimize poorly structured SKILL.md files with frontmatter validation and duplication reduction.

21|Updated Jan 3, 2026
Search Tags:#documentation#optimize#skill#workflows#frontmatter
One-click install
npx skills add https://github.com/kevinslin/skills --skill meta-skill-optimizer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: meta.skill-optimizer
Source: https://github.com/kevinslin/skills/tree/main/active/meta.skill-optimizer
Command: npx skills add https://github.com/kevinslin/skills --skill meta-skill-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Optimizes existing skills by clarifying objectives, consolidating duplicated instructions, and moving long-form guidance into references to improve maintainability and onboarding.

Core Features & Use Cases

  • Centralizes frontmatter validation (name, description) and aligns scope with real workflows
  • Reorganizes content to reduce duplication, balance SKILL.md vs references, and improve discoverability
  • Provides concrete, testable recommendations and edits, with optional trace-based history analysis for deeper optimization

Quick Start

Review a target skill's SKILL.md, propose concrete improvements, and apply edits after your confirmation.

Frequently Asked Questions about meta.skill-optimizer

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

FAQPage Schema
How do I optimize SKILL.md files to reduce content duplication and improve clarity?▼

To optimize SKILL.md files, identify poorly structured content, validate frontmatter, consolidate duplicated instructions, and push detailed guidance into references to streamline workflows and improve maintainability.

What is the best way to reorganize documentation frontmatter for better skill discoverability?▼

Reorganizing documentation frontmatter involves validating name and description fields, aligning scope with real workflows, and balancing SKILL.md content versus references to improve discoverability and onboarding.

How do I consolidate duplicated instructions in workflows and skill documentation?▼

Consolidating duplicated instructions in workflows requires analyzing the SKILL.md structure, identifying overlapping content, and proposing concrete edits that centralize guidance into references for better maintainability.

Can I use trace-based analysis to optimize poorly structured documentation?▼

Yes, you can request optional trace-based history analysis to perform deeper optimization of poorly structured documentation, producing concrete, testable recommendations and proposed edits for clarity.

When should I move detailed guidance from SKILL.md into references?▼

You should move detailed guidance into references when SKILL.md content becomes overly long or duplicated, ensuring the main file stays concise while maintaining full documentation in reference files for onboarding.

Related Skills

Explore More Content & Communication Skills→
Azure-SamplesAzure-Samples
970

skill-creator

Generates a standardized skill scaffold with SKILL.md frontmatter and example resource directories.

Official
Basic
ionfuryionfury
24

sync-claude

Validate and synchronize CLAUDE.md and SKILL.md documentation before commits.

Community
Advanced
ripgraphicsripgraphics

documentation-expert

Analyze documentation structure, navigation depth, and content cohesion.

Community
Advanced
BasharAmsoBasharAmso
1

Refactoring

Refactor codebases by extracting components, renaming, and reducing duplication without changing runtime behavior.

Community
Intermediate