google-search-console
Compatibility pointer for Search Console performance and indexing analysis; maintained in Open Analytics.
@kostja94Install SkillMarketing
Skill
/description
When the user wants to write, audit, or optimize a meta description, SEO description, SERP snippet candidate, duplicate description, description length, or description rewrite issue. For a sitewide metadata lifecycle including implementation and production validation, use
Claude Code
$ npx -y skills add kostja94/marketing-skills --skill description --agent claude-code
Codex
$ npx skills add kostja94/marketing-skills --skill description -a codex -y
Cursor
$ npx skills add kostja94/marketing-skills --skill description -a cursor -y
Gemini CLI
$ npx skills add kostja94/marketing-skills --skill description -a gemini-cli -y
GitHub Copilot
$ npx skills add kostja94/marketing-skills --skill description -a github-copilot -y
OpenCode
$ npx skills add kostja94/marketing-skills --skill description -a opencode -y
Windsurf
$ npx skills add kostja94/marketing-skills --skill description -a windsurf -y
SKILL.md
description.SKILL.mdname: meta-description
description: When the user wants to write, audit, or optimize a meta description, SEO description, SERP snippet candidate, duplicate description, description length, or description rewrite issue. For a sitewide metadata lifecycle including implementation and production validation, use page-metadata.
metadata:
version: 2.0.0
SEO On-Page: Meta Description
Owns writing and review rules for `<meta name="description">`. It is a candidate source for search snippets, not a guarantee of the text Google will display.
Inputs
Read root `{project}.md` when present. Confirm page type, primary search intent, locale, verified page-specific facts, current description, body coverage, sibling-page descriptions, and the intended next action when one exists.
Rules
- Write an accurate, useful summary or pitch for the specific page.
- Lead with information that distinguishes this page from sibling pages.
- Use query-relevant language naturally, without a keyword list.
- Length is a warning, not a hard gate. Google has no fixed meta-description length limit and truncates snippets as needed for the device and result context.
- A description may exceed traditional character guidance when it remains concise and useful. Flag descriptions too short to explain value or too long because of filler, repetition, or boilerplate.
- Use a CTA only when it suits the page task. Do not force marketing CTAs into legal, documentation, status, or informational pages.
- Include price, author, date, availability, or compatibility only when present and current on the page.
- Apply the **Swap Test**: if a description can move unchanged to a sibling page, it is not specific enough.
- Localize from the target market's query language and intent; do not translate and truncate.
- Google primarily creates snippets from page content and may show different text for different queries. Ensure the H2/body can substantiate the description's promise.
- Do not claim a fixed CTR, ranking, or traffic increase. A meta description is not a direct ranking control.
Output
- Recommended description and a non-binding length warning when useful.
- Brief rationale tied to intent and page-specific facts.
- Body-coverage warning if the page cannot substantiate the proposed description.
- Sibling duplication or cannibalization warning when applicable; do not restructure pages.
Primary reference
- [Google: snippets and meta descriptions](https://developers.google.com/search/docs/appearance/snippet)
Related Skills
- **page-metadata**, **title-tag**, **heading-structure**
- **localization-strategy**, **translation**, **google-search-console**
Read more
name: meta-description description: When the user wants to write, audit, or optimize a meta description, SEO description, SERP snippet candidate, duplicate description, description length, or description rewrite issue. For a sitewide metadata lifecycle including implementation and production validation, use page-metadata. metadata: version: 2.0.0
SEO On-Page: Meta Description
Owns writing and review rules for `<meta name="description">`. It is a candidate source for search snippets, not a guarantee of the text Google will display.
Inputs
Read root `{project}.md` when present. Confirm page type, primary search intent, locale, verified page-specific facts, current description, body coverage, sibling-page descriptions, and the intended next action when one exists.
Rules
- Write an accurate, useful summary or pitch for the specific page.
- Lead with information that distinguishes this page from sibling pages.
- Use query-relevant language naturally, without a keyword list.
- Length is a warning, not a hard gate. Google has no fixed meta-description length limit and truncates snippets as needed for the device and result context.
- A description may exceed traditional character guidance when it remains concise and useful. Flag descriptions too short to explain value or too long because of filler, repetition, or boilerplate.
- Use a CTA only when it suits the page task. Do not force marketing CTAs into legal, documentation, status, or informational pages.
- Include price, author, date, availability, or compatibility only when present and current on the page.
- Apply the **Swap Test**: if a description can move unchanged to a sibling page, it is not specific enough.
- Localize from the target market's query language and intent; do not translate and truncate.
- Google primarily creates snippets from page content and may show different text for different queries. Ensure the H2/body can substantiate the description's promise.
- Do not claim a fixed CTR, ranking, or traffic increase. A meta description is not a direct ranking control.
Output
- Recommended description and a non-binding length warning when useful.
- Brief rationale tied to intent and page-specific facts.
- Body-coverage warning if the page cannot substantiate the proposed description.
- Sibling duplication or cannibalization warning when applicable; do not restructure pages.
Primary reference
- [Google: snippets and meta descriptions](https://developers.google.com/search/docs/appearance/snippet)
Related Skills
- **page-metadata**, **title-tag**, **heading-structure**
- **localization-strategy**, **translation**, **google-search-console**
Stats
1,094
Stars
150
Forks
Active
Maintenance
MIT
License
Last commit
Created
Ships withmarketing-skills
Marketing Skills is an open-source library of reusable marketing and SEO workflows for AI agents. Install the skills your task needs, provide real product context, and get structured work grounded in explicit methods, checks, and source rules.
1.1k171 skills
Stars on GitHub
Momentum
- stars in total
- 1.1k
Other skills on marketing-skills.
@kostja94Install Skillseo-monitoring
Compatibility pointer for recurring SEO monitoring; maintained in Open Analytics.
@kostja94Install Skillai-traffic
Compatibility pointer for AI assistant referrals and generative search visibility; maintained in Open Analytics.
@kostja94Install Skilltraffic
Compatibility pointer for source, UTM and direct-traffic analysis; maintained in Open Analytics.
@kostja94Install Skilltracking
Compatibility pointer for GA4 event, key-event and User-ID tracking; maintained in Open Analytics.
@kostja94Install Skillcommunity-forum
When the user wants to promote via forums, communities, or invite users to join a community. Also use when the user mentions…
@kostja94Install SkillMore skills from other plugins.
Auto-invoked
ab-testing
When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use…
@coreyhaines31Install Skillseo
Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability,…
@agricidanielInstall Skillbrag
Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone says "/brag",…
@latent-spacesInstall Skillgeo-audit
Full website GEO+SEO audit with parallel subagent delegation. Orchestrates a comprehensive Generative Engine Optimization audit…
@zubair-trabzadaInstall SkillQuestions about description.
- Which coding agents can use description?
- description installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.