Agent skill

Mobile Friendly

by kostja94 in kostja94/marketing-skills

When the user wants to optimize for mobile-first indexing or fix mobile usability.

MITAuto-check passedFrontend & Design

Install Mobile Friendly

skills CLI
$ npx skills add kostja94/marketing-skills --skill mobile-friendly -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills mobile-friendly --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo/technical/mobile-friendly .claude/skills/mobile-friendly && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mobile-friendly
GitHub stars
1k
Token cost
~1.5k tokens
SKILL.md length
653 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to optimize for mobile-first indexing or fix mobile usability.

  • Works in 3 steps: Site type: Responsive, separate AMP,… → Content parity: Does mobile show same… → Tools: GSC Mobile Usability report;…
  • Wants to optimize for mobile-first indexing
  • SKILL.md covers Scope (Technical SEO), Initial Assessment, Mobile-First Indexing… and Responsive Design & Mobile…, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mobile Friendly is an agent skill from kostja94/marketing-skills. When the user wants to optimize for mobile-first indexing or fix mobile usability. Also use when the user mentions "mobile-friendly," "mobile-first indexing," "mobile SEO," "responsive design," "mobile adaptation," "mobile viewport," "viewport meta," "touch targets," "font size mobile," "AMP," or "Accelerated Mobile Pages." For viewport meta, use page-metadata.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Responsive design, UX design and Mobile UI design. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to optimize for mobile-first indexing
  • Fix mobile usability
  • The user mentions mobile-friendly
  • Mobile-first indexing

Example prompts

  • “mobile-friendly,”
  • “mobile-first indexing,”
  • “mobile SEO,”
  • “/mobile-friendly”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Site type: Responsive, separate AMP, dynamic serving
  2. Content parity: Does mobile show same content as desktop?
  3. Tools: GSC Mobile Usability report; Mobile-Friendly Test

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • search.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mobile Friendly loads about 1.5k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 653 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 653 words, ~1,519 tokens.

Download SKILL.mdSave it as .claude/skills/mobile-friendly/SKILL.md (or your agent's skills folder).
name
mobile-friendly
description
When the user wants to optimize for mobile-first indexing or fix mobile usability. Also use when the user mentions "mobile-friendly," "mobile-first indexing," "mobile SEO," "responsive design," "mobile adaptation," "mobile viewport," "viewport meta," "touch targets," "font size mobile," "AMP," or "Accelerated Mobile Pages." For viewport meta, use page-metadata.
metadata.version
1.1.2

SEO Technical: Mobile-Friendly

Guides mobile-first indexing optimization and mobile usability. Google uses the mobile version of pages for indexing and ranking; mobile-friendliness is a ranking factor.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Scope (Technical SEO)

  • Mobile-first indexing: Google primarily crawls and indexes mobile version
  • Mobile adaptation: Responsive design, viewport, breakpoints
  • Content parity: Mobile and desktop content should match (or mobile preferred)
  • Mobile usability: Viewport, font size, touch targets, no intrusive interstitials
  • AMP: Accelerated Mobile Pages—status and when to consider

Initial Assessment

Project context: Read root contextus.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:

  1. Site type: Responsive, separate AMP, dynamic serving
  2. Content parity: Does mobile show same content as desktop?
  3. Tools: GSC Mobile Usability report; Mobile-Friendly Test

Mobile-First Indexing Requirements

RequirementAction
Content parityMobile version must include same primary content as desktop; avoid hiding key content on mobile
Structured dataSame schema on mobile and desktop; ensure mobile URLs in schema
MetadataSame title, meta description on mobile
MediaImages should be crawlable; avoid lazy-loading above-fold images

Responsive Design & Mobile Adaptation

Responsive design = Single HTML; CSS media queries adapt layout to screen size. Preferred for SEO: one URL, no duplicate content.

PrinciplePractice
Mobile-firstDesign for mobile first; enhance for desktop
Fluid layoutUse %, vw, flex, grid; avoid fixed pixel widths
BreakpointsCommon: 320px, 768px, 1024px, 1280px; match device widths
ImagesResponsive images (srcset, sizes); see image-optimization

Viewport

The viewport meta tag tells browsers how to scale and size the page on mobile. Required for mobile-friendly pages.

html
<meta name="viewport" content="width=device-width, initial-scale=1">
AttributePurpose
width=device-widthMatch viewport to device screen width
initial-scale=11:1 scale on load; prevents zoom
maximum-scaleAvoid disabling zoom (accessibility)
user-scalable=noAvoid—hurts accessibility

Without viewport: Desktop layout shrunk; horizontal scroll; fails Mobile-Friendly Test. See page-metadata.

Mobile Usability Checklist

ElementGuideline
ViewportSee above; required for mobile-friendly
Font size16px minimum for body text; avoid zooming to read
Touch targetsButtons/links ≥48×48px; adequate spacing between taps
Content widthNo horizontal scrolling; content fits viewport
Intrusive interstitialsAvoid popups that block main content on mobile
Show full SKILL.md (258 more words)Show less

Common Issues

IssueFix
Content hidden on mobileShow critical content; avoid accordion/tabs for primary content
Flash / unsupportedReplace with HTML5 alternatives
Text too smallUse base font ≥16px; avoid font-size in px <12
Links too closeIncrease tap target size; add padding

Responsive vs. Separate URLs

ApproachWhenNote
ResponsivePreferredSingle URL; same HTML, CSS media queries
Dynamic servingSame URL, different HTML by user-agentEnsure mobile content parity
Separate URLsm.example.comUse canonical + hreflang; see canonical-tag, page-metadata

Accelerated Mobile Pages (AMP)

AMP is a web component framework for fast-loading pages. Status (2024–2025): Still supported; no longer required for Top Stories or ranking.

AspectNote
RankingNo ranking advantage over well-optimized responsive pages
Top StoriesAMP no longer required since 2021; Core Web Vitals suffice
When to considerNews sites, ad-heavy pages, very slow hosting—but responsive + CWV usually better
AlternativeResponsive design + core-web-vitals optimization; SSR/SSG; see rendering-strategies

Recommendation: For most sites, prioritize responsive design and Core Web Vitals over AMP. AMP adds maintenance (separate AMP HTML); modern optimization offers similar performance with more flexibility.

Output Format

  • Mobile Usability status: Pass/fail from GSC or Mobile-Friendly Test
  • Responsive / viewport: Check viewport meta; breakpoints; fluid layout
  • Content parity: Mobile vs desktop content check
  • AMP: Only if legacy or specific use case
  • Fixes: Prioritized by impact
  • page-metadata: Viewport meta tag; required for mobile
  • core-web-vitals: CWV measured on mobile; replaces AMP for Top Stories; LCP, INP, CLS
  • canonical-tag: Separate mobile URLs; hreflang for mobile
  • image-optimization: Responsive images; mobile LCP
  • rendering-strategies: SSR/SSG for fast mobile load
  • google-search-console: Mobile Usability report

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/seo/technical/mobile-friendly of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Mobile Friendly next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mobile Friendly compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mobile Friendly this skillkostja94/marketing-skills1k—~1.5kAutomated safety check: PassMIT
Bmad UXaj-geddes/claude-code-bmad-skills488—~2kAutomated safety check: NotesCustom licence
Acarshub Design Languagesdr-enthusiasts/docker-acarshub117—~1.1kAutomated safety check: PassGPL-3.0
Responsive Mobile FirstBlackBeltTechnology/pi-agent-dashboard315—~2.1kAutomated safety check: PassMIT
GstackLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: NotesMIT
Fitts Lawhashgraph-online/awesome-codex-plugins1.3k—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Bmad UX

    aj-geddes/claude-code-bmad-skills

    Solutioning-phase UX planning skill (optional; activate when the project has a UI).

    488 GitHub stars~2k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check: notes
  • Acarshub Design Language

    sdr-enthusiasts/docker-acarshub

    Use ONLY when working in the docker-acarshub repository AND building UI -- React components, SCSS modules, theme variables, accessibility, mobile responsiveness, Catppuccin color usage, Zustand…

    117 GitHub stars~1.1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Responsive Mobile First

    BlackBeltTechnology/pi-agent-dashboard

    Mobile-first responsive patterns with sticky headers, floating CTAs, accessible navigation, and touch-friendly interactions.

    315 GitHub stars~2.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Gstack

    LeoYeAI/openclaw-master-skills

    Fast headless browser for QA testing and site dogfooding. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes
  • Fitts Law

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses whenever the question involves how easy it is to hit an interactive target — buttons, links, form controls, drag handles, scrollbars, mobile tap targets, anything the user…

    1.3k GitHub stars~3.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Browse

    LeoYeAI/openclaw-master-skills

    Fast headless browser for QA testing and site dogfooding. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3.2k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 3 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 3 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

Questions about Mobile Friendly

What does Mobile Friendly do?

When the user wants to optimize for mobile-first indexing or fix mobile usability. Mobile Friendly is an agent skill from kostja94/marketing-skills. When the user wants to optimize for mobile-first indexing or fix mobile usability.

When should I use Mobile Friendly?

Mobile Friendly fits situations like: wants to optimize for mobile-first indexing; fix mobile usability; the user mentions mobile-friendly; mobile-first indexing.

How do I install Mobile Friendly in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill mobile-friendly -a claude-code`. Or copy the skill folder (skills/seo/technical/mobile-friendly in kostja94/marketing-skills) into .claude/skills/mobile-friendly in your project. Claude Code loads it when a task matches its description.

How do I install Mobile Friendly in Codex?

Run `npx skills add kostja94/marketing-skills --skill mobile-friendly -a codex`. Or copy the skill folder (skills/seo/technical/mobile-friendly in kostja94/marketing-skills) into .agents/skills/mobile-friendly in your project. Codex loads it when a task matches its description.

Can I use Mobile Friendly in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill mobile-friendly -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobile-friendly, .gemini/skills/mobile-friendly, .github/skills/mobile-friendly and .opencode/skills/mobile-friendly in your project.

What does Mobile Friendly need to run?

SKILL.md names no scripts, command-line tools or credentials: Mobile Friendly is instructions for the agent only.

Does Mobile Friendly access the network?

SKILL.md names 1 domain. As links in the text: search.google.com. This is read from the text; nothing was executed.

Is Mobile Friendly safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mobile Friendly use?

Mobile Friendly is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mobile Friendly use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mobile Friendly?

Skills that share tags, products or a category with Mobile Friendly: Bmad UX (aj-geddes/claude-code-bmad-skills, 488 stars), Acarshub Design Language (sdr-enthusiasts/docker-acarshub, 117 stars), Responsive Mobile First (BlackBeltTechnology/pi-agent-dashboard, 315 stars) and Gstack (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mobile Friendly?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,025 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.