skills.rest
scanady
scanadyCOMMUNITY
Explore all skills by this author →
GitHub

skill-metadata

Refine SKILL.md frontmatter metadata fields for improved skill triggering.

Updated Jan 28, 2026
Search Tags:#routing#optimization#discovery#metadata#skill#frontmatter
One-click install
npx skills add https://github.com/scanady/forge-agents --skill skill-metadata
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-metadata
Source: https://github.com/scanady/forge-agents/tree/main/.agents/skills/skill-metadata
Command: npx skills add https://github.com/scanady/forge-agents --skill skill-metadata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enhances the discoverability and triggering reliability of other skills by optimizing their metadata block in SKILL.md frontmatter.

Core Features & Use Cases

  • Metadata Improvement: Refines metadata fields like triggers, domain, role, and scope based on skill content.
  • Discoverability Enhancement: Ensures skills are found and activated by the correct user prompts.
  • Use Case: You have a skill that helps with API design, but it's not being triggered often. This Skill can analyze the skill's content and add relevant triggers and domain metadata to improve its visibility.

Quick Start

Use the skill-metadata skill to improve the metadata for the 'tech-prd-generator' skill.

Frequently Asked Questions about skill-metadata

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

FAQPage Schema
How do I optimize skill metadata for better routing and discoverability?▼

To optimize skill metadata for better routing and discoverability, refine the `metadata` block in `SKILL.md` frontmatter by adjusting fields like `triggers`, `domain`, `role`, `scope`, and `output-format` based on the skill's content.

Why does my custom skill fail to trigger when users search for its intended task?▼

A custom skill fails to trigger when its `SKILL.md` frontmatter lacks accurate `triggers` and `domain` metadata. Analyzing the skill's content and updating these fields ensures it is found and activated by the correct user prompts.

What is the best way to improve frontmatter discovery for an API design skill?▼

The best way to improve frontmatter discovery for an API design skill is to analyze its content and add relevant `triggers` and `domain` metadata to the `SKILL.md` frontmatter, ensuring it matches intended user prompts.

Can I use metadata refinement to fix skill triggering issues across different domains?▼

Yes, metadata refinement fixes skill triggering issues by updating the `scope` and `role` fields in the `SKILL.md` frontmatter, aligning the skill's routing optimization with its actual content and intended use cases across domains.

When do I need to update the output-format and scope metadata in a SKILL.md file?▼

You need to update the `output-format` and `scope` metadata in a `SKILL.md` file when the skill's content or intended use changes, ensuring accurate skill triggering and enhanced discoverability for meta-level skill management.

Related Skills

Explore More Software Engineering Skills→
marcoamumarcoamu
1

scrapling-official

Extract structured YAML metadata from SKILL.md frontmatter and optional resources.

Community
Intermediate
zeroclaw-labszeroclaw-labs
32.5k

skill-creator

Create and refine AI skills with SKILL.md and automated testing.

Official
Advanced
JingyiWngJingyiWng

bmad-distillator

Extract lossless, token-efficient distillates from source documents.

Community
Advanced
yankeeinlondonyankeeinlondon
3

{{library_name}}

Generate Claude Code Agent Skills with frontmatter-driven SKILL.md and linked content.

Community
Advanced