# Template for new Skill landing pages
# Copy to skills/content/{slug}.yaml and fill in all sections.
# Build: python3 scripts/build-skills.py
# Also add entry to skills/catalog.yaml
#
# Layouts:
#   classic (default) — full documentation-style landing (19 sections)
#   conversion — focused demo landing (8–10 sections, single primary CTA)
#
# For conversion layout set: page_layout: conversion
# Required: hero, outcomes (4), example (rows), comparison (4), workflow (4 steps),
# use_cases (4), faq (5), pricing_note, related_articles (3)

page_layout: classic  # classic | conversion

slug: example-skill  # must match filename and catalog.yaml entry

seo:
  title: "Unique page title — Skill example-skill | MCP Panel"
  description: "150–160 chars unique meta description for search and AI snippets."
  h1: "User problem as H1 — not the skill name"

hero:
  subtitle: "One-line value proposition"
  lede: "2–3 sentences: scenario, data source, outcome"
  audience: "SEO, маркетологи, агентства"
  task: "Concrete job the skill solves"
  result: "Measurable outcome for the user"

prompts_title: 'Task headline — <span class="it">accent phrase</span>.'
prompts_lede: "Lead for quick_questions section"
quick_questions:
  - "Example prompt 1"
  - "Example prompt 2"

architecture_title: 'Skill — <span class="it">on your server</span>.'
architecture_source: example-skill
architecture_source_desc: "What the skill produces"
architecture_hub_desc: "Skill workflow, OAuth, журнал запросов"
setup_title: 'Skill в MCP Panel — <span class="it">демо и запуск</span>.'

related_links:
  title: "Что посмотреть дальше"
  items:
    - href: /skills-catalog/
      title: Каталог Skills
      desc: "All author skills"

hero_badges:  # optional
  - Category name
  - MCP Panel

jtbd:
  - when: "Situation trigger"
    want: "Desired action"
    so_that: "Business outcome"
  - when: "..."
    want: "..."
    so_that: "..."

pains:
  - "Pain point 1 — not a feature"
  - "Pain point 2"

workflow:
  steps:
    - "Input data"
    - "MCP Panel"
    - "Connector / analysis"
    - "Output report"

capabilities:
  - "Concrete capability"

outcomes:
  - "✓ Saves N hours"
  - "✓ Standardizes process"

connectors:
  - name: Яндекс Wordstat
    required: true
    url: /connectors/wordstat/
    desc: "Short connector role"

segments:
  - "✔ SEO-специалист"
  - "✔ Маркетолог"

vs_chatgpt:
  skill_points:
    - "Uses real MCP data"
    - "Repeatable workflow"
  chatgpt_points:
    - "One-off answer"
    - "No access to your accounts"

knowledge_graph:
  tasks: []
  professions: []
  industries: []
  processes: []
  entities: []
  ai_models: []

geo:
  brief:
    - label: "Skill"
      text: "One-sentence definition"
  when_use: []
  when_not: []
  limitations: []
  definitions:
    - term: "Term"
      definition: "Clear definition for AI search"

example:
  caption: "Example output"
  content: |
    Markdown or text sample

architecture:
  lede: "How the skill runs on MCP Panel"
  steps:
    - "Request"
    - "MCP"
    - "Report"

article:
  problem: "..."
  cause: "..."
  consequences: []
  what_to_check: []
  solution: "..."
  next_step: "..."
  sections:
    - heading: "Expert section H2"
      paragraphs:
        - "Paragraph text"
      list:
        - "Checklist item"

faq:
  - q: "Skill-specific question?"
    a: "Answer"

related_skills:
  - other-skill-slug

wiki_links:
  - title: "MCP — что это"
    url: /wiki/mcp-chto-eto/

news_links:
  - title: "News article title"
    url: /news/slug/
