skill-frontmatter-optimizer

Analyze and optimize YAML frontmatter metadata in SKILL.md files.

5|1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/IngmarKrusch/agentic --skill skill-frontmatter-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-frontmatter-optimizer
Source: https://github.com/IngmarKrusch/agentic/tree/main/skills/skill-frontmatter-optimizer
Command: npx skills add https://github.com/IngmarKrusch/agentic --skill skill-frontmatter-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Frontmatter is the sole trigger for many skills. When poorly written or inconsistent, automatic invocation drops. This guide describes how to analyze and optimize SKILL.md frontmatter to improve reliability and predictability.

Core Features & Use Cases

  • Analyze existing SKILL.md to extract frontmatter, body hints, and potential trigger phrases.
  • Generate an optimized, production-ready description that clearly communicates when to invoke the skill and enumerated scenarios.
  • Validate generated frontmatter against best practices and provide a simple quick-start workflow for applying changes.

Quick Start

Run the analyzer to extract key details from this skill, then run the generator to create and apply an optimized frontmatter description.

Frequently Asked Questions about skill-frontmatter-optimizer

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

FAQPage Schema
Why does my skill fail to trigger automatically during workflows?

Automatic skill invocation drops when YAML frontmatter is poorly written or inconsistent. Optimizing frontmatter metadata by applying production-ready patterns and concise enumerated triggers ensures reliable skill triggering.

How do I optimize YAML frontmatter to improve skill invocation reliability?

To optimize YAML frontmatter, extract existing metadata and body hints, validate the presence of name and description, then rewrite metadata with an enumerated trigger pattern within the 1024-character limit.

What is the character limit for a SKILL.md frontmatter description?

The frontmatter description must fit within a 1024-character limit. Keeping the description concise and using an enumerated trigger pattern ensures it meets validation best practices.

Do I need pyyaml to analyze and rewrite frontmatter metadata?

Yes, pyyaml is required. This dependency allows the script to parse, validate, and rewrite the YAML frontmatter metadata into production-ready patterns for better automatic invocation.

What is the best way to write a frontmatter description for reliable triggering?

The best way to write frontmatter is to use a concise, enumerated trigger pattern with clear examples. This production-ready pattern clearly communicates when to invoke the skill across workflows.

Can I validate existing SKILL.md frontmatter against best practices?

Yes, you can validate existing frontmatter by analyzing the extracted metadata to confirm the presence and correctness of the name and description fields and diagnosing any triggering gaps.