docs-frontmatter-description

Generate and refine meta descriptions in Elastic documentation frontmatter.

71|10|Updated Aug 20, 2025
One-click install
npx skills add https://github.com/elastic/elastic-docs-skills --skill docs-frontmatter-description
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-frontmatter-description
Source: https://github.com/elastic/elastic-docs-skills/tree/main/skills/authoring/frontmatter-description
Command: npx skills add https://github.com/elastic/elastic-docs-skills --skill docs-frontmatter-description

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating effective meta descriptions for documentation, ensuring better search engine discoverability and adherence to SEO best practices.

Core Features & Use Cases

  • Automated Description Generation: Creates or improves description fields in YAML frontmatter.
  • SEO Best Practice Adherence: Follows guidelines for length, tone, and content.
  • Content Type Awareness: Adapts descriptions for tutorials, troubleshooting, reference, and standard pages.
  • Use Case: When adding new documentation pages or auditing existing ones, use this Skill to automatically generate or refine meta descriptions, improving their visibility in search results.

Quick Start

Use the frontmatter-description skill to process the file '/path/to/your/document.md'.

Frequently Asked Questions about docs-frontmatter-description

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

FAQPage Schema
How do I generate SEO meta descriptions for markdown documentation frontmatter?

You can generate SEO meta descriptions for markdown frontmatter by applying automated guidelines that ensure descriptions are concise, action-oriented, and contextually relevant to the specific document type. This optimizes individual files or entire directories for search engine discoverability.

What are the SEO best practices for writing documentation descriptions in YAML?

SEO best practices for YAML documentation descriptions require checking length limits, maintaining an active voice, ensuring correct sentence structure, and avoiding specific forbidden words and version numbers. The content must be concise and action-oriented to improve search visibility.

Can I automatically optimize frontmatter descriptions for an entire directory of markdown files?

Yes, you can automatically optimize frontmatter descriptions for an entire directory of markdown files. The process applies SEO best practices across all documents, adapting the generated descriptions to match the specific content type of each file.

How does content type awareness affect meta description generation for troubleshooting pages versus tutorials?

Content type awareness tailors the generated meta descriptions to match the intent of the specific document, ensuring troubleshooting pages and tutorials receive distinct, contextually relevant summaries that adhere to SEO length and tone requirements.

Why should I avoid version numbers and specific forbidden words in documentation meta descriptions?

Avoiding version numbers and forbidden words in documentation meta descriptions prevents content from becoming outdated quickly and ensures adherence to strict SEO best practices. This maintains search engine discoverability and keeps the descriptions universally relevant.

What is the best way to audit and refine existing Elastic documentation meta descriptions?

The best way to audit and refine existing Elastic documentation meta descriptions is to process the target markdown files through automated description generation. This evaluates current YAML fields against SEO guidelines and rewrites them to be concise and action-oriented.