Claude Skill

editorial-surface

Shape editorial and reading-first surfaces with strong hierarchy, readable measure, and disciplined media rhythm. Use for articles, guides, books, blog indexes, featured/recent cards, and other longform or text-heavy public surfaces.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download markoblogo-abvx-agent-skills-skills_editorial-surface-37a7146.zip · 2 KB

Install

skills CLI npx skills add https://github.com/markoblogo/abvx-agent-skills/tree/main/skills/editorial-surface
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install markoblogo-abvx-agent-skills@llmmart
Git git clone https://github.com/markoblogo/abvx-agent-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole markoblogo/abvx-agent-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Editorial Surface

Treat reading experience as a product requirement, not decorative polish.

Use this when the surface is text-first and the common failure mode is bad hierarchy, empty cards, oversized hero treatments, weak excerpt logic, or unreadable body rhythm.

Best Fit

  • article pages;
  • blog and writing indexes;
  • guide pages;
  • book and booklet landing sections;
  • featured and recent content cards;
  • mixed text/media editorial layouts.

Design Priorities

  • title, deck, metadata, and body must read as one system;
  • body measure and paragraph rhythm win over decorative hero treatment;
  • cards should carry the right amount of information for their role;
  • media should support reading, not interrupt it;
  • text-only surfaces should still feel intentionally composed.

Workflow

  1. Identify the content role:
    • index, featured card, recent card, article page, guide, or mixed editorial section.
  2. State the reading job:
    • skim, choose, commit, or read deeply.
  3. Check the hierarchy:
    • label/source/date;
    • title;
    • deck/excerpt;
    • body;
    • supporting media;
    • actions and related links.
  4. Fix the common structural failures first:
    • oversized title block;
    • empty right side on text-only featured cards;
    • recent cards with dead space instead of useful excerpt;
    • metadata too faint to scan;
    • body too light, narrow, or long-line;
    • video or external resources placed without narrative rhythm.
  5. For mixed media, place media where it helps comprehension:
    • not automatically adjacent to cover art if that creates a media wall;
    • not after the entire article if it belongs near the core narrative.
  6. Verify desktop and mobile reading comfort before calling the change ready.

Output Shape

Return:

  • content role
  • reading job
  • hierarchy fixes
  • excerpt rule
  • media placement rule
  • desktop/mobile reading checks

Guardrails

  • Do not rewrite owner-approved article body unless explicitly asked.
  • Do not turn editorial pages into generic marketing pages.
  • Do not add decorative imagery to cover for weak hierarchy.
  • Do not shrink content density so far that text-first surfaces become empty.
  • Do not imitate Medium or Substack blindly when the project has its own identity.

Final Report

Include:

  • the content role handled;
  • the main hierarchy correction;
  • the excerpt or media rule applied;
  • desktop/mobile reading evidence;
  • any remaining issue that still needs anti-slop-review or browser-verification.
Files (abvx-agent-skills)
  • agents
    • openai.yaml 239 B
      Loading…
  • SKILL.md 2.8 KB
    ---
    name: editorial-surface
    description: Shape editorial and reading-first surfaces with strong hierarchy, readable measure, and disciplined media rhythm. Use for articles, guides, books, blog indexes, featured/recent cards, and other longform or text-heavy public surfaces.
    license: MIT
    metadata:
      abvx_status: experimental
      abvx_origin: adapted
      abvx_eval_tier: structural_only
    ---
    
    # Editorial Surface
    
    Treat reading experience as a product requirement, not decorative polish.
    
    Use this when the surface is text-first and the common failure mode is bad hierarchy, empty cards, oversized hero treatments, weak excerpt logic, or unreadable body rhythm.
    
    ## Best Fit
    
    - article pages;
    - blog and writing indexes;
    - guide pages;
    - book and booklet landing sections;
    - featured and recent content cards;
    - mixed text/media editorial layouts.
    
    ## Design Priorities
    
    - title, deck, metadata, and body must read as one system;
    - body measure and paragraph rhythm win over decorative hero treatment;
    - cards should carry the right amount of information for their role;
    - media should support reading, not interrupt it;
    - text-only surfaces should still feel intentionally composed.
    
    ## Workflow
    
    1. Identify the content role:
       - index, featured card, recent card, article page, guide, or mixed editorial section.
    2. State the reading job:
       - skim, choose, commit, or read deeply.
    3. Check the hierarchy:
       - label/source/date;
       - title;
       - deck/excerpt;
       - body;
       - supporting media;
       - actions and related links.
    4. Fix the common structural failures first:
       - oversized title block;
       - empty right side on text-only featured cards;
       - recent cards with dead space instead of useful excerpt;
       - metadata too faint to scan;
       - body too light, narrow, or long-line;
       - video or external resources placed without narrative rhythm.
    5. For mixed media, place media where it helps comprehension:
       - not automatically adjacent to cover art if that creates a media wall;
       - not after the entire article if it belongs near the core narrative.
    6. Verify desktop and mobile reading comfort before calling the change ready.
    
    ## Output Shape
    
    Return:
    
    - `content role`
    - `reading job`
    - `hierarchy fixes`
    - `excerpt rule`
    - `media placement rule`
    - `desktop/mobile reading checks`
    
    ## Guardrails
    
    - Do not rewrite owner-approved article body unless explicitly asked.
    - Do not turn editorial pages into generic marketing pages.
    - Do not add decorative imagery to cover for weak hierarchy.
    - Do not shrink content density so far that text-first surfaces become empty.
    - Do not imitate Medium or Substack blindly when the project has its own identity.
    
    ## Final Report
    
    Include:
    
    - the content role handled;
    - the main hierarchy correction;
    - the excerpt or media rule applied;
    - desktop/mobile reading evidence;
    - any remaining issue that still needs `anti-slop-review` or `browser-verification`.
    
  • SKILL_CARD.md 1.7 KB
    Loading…

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.