Agent skill

SEO AI Social Report

by seranking in seranking/seo-skills

Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a…

MITAuto-check passedMarketing & SEO

Install SEO AI Social Report

skills CLI
$ npx skills add seranking/seo-skills --skill seo-ai-social-report -a claude-code

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

GitHub CLI
$ gh skill install seranking/seo-skills seo-ai-social-report --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/seranking/seo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-ai-social-report .claude/skills/seo-ai-social-report && 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
seo-ai-social-report
GitHub stars
161
Token cost
~1.8k tokens
SKILL.md length
860 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a…

  • Works in 6 steps: Scope → Pull SEO (SE Ranking) → Pull AI search (SE Ranking) → …
  • The user wants a combined cross-channel report
  • SKILL.md covers Prerequisites, Connector health check, Process and Output, plus 2 more sections
  • Calls node

What it does

SEO AI Social Report is an agent skill from seranking/seo-skills. Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a self-contained interactive HTML report. Use this skill whenever the user wants a combined cross-channel report, or says things like "give me a full report across SEO and social", "how did we do this month across search and social", "combined SEO + AI + social report for [client]", "build a cross-channel dashboard", or "one…

Its SKILL.md is about 1.8k 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 Marketing & SEO, covering AI search optimization and HTML artifacts. The repository describes itself as: Claude SEO Skills — production Claude Agent Skills for the SE Ranking MCP server. Content briefs, AI Search share of voice, audits, backlink gaps, keyword clusters, schema… The licence is MIT.

When your agent uses it

  • The user wants a combined cross-channel report
  • Says things like give me a full report across SEO and social
  • How did we do this month across search and social
  • Combined SEO + AI + social report for [client]

Example prompts

  • “give me a full report across SEO and social”
  • “how did we do this month across search and social”
  • “combined SEO + AI + social report for [client]”
  • “/seo-ai-social-report”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Scope
  2. Pull SEO (SE Ranking)
  3. Pull AI search (SE Ranking)
  4. Pull social (Planable)
  5. Write the quick conclusions (chat)
  6. Build the interactive HTML report

What it can do on your machine

Read from SKILL.md and the folder at commit fd6d140. 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

    Shell commands in SKILL.md call:

    • node

    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):

    • seranking.com
    • help.planable.io

    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

SEO AI Social Report loads about 1.8k tokens when it runs. Until then it costs about 175 tokens; SKILL.md has 860 words of instructions outside code blocks.

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

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 seranking/seo-skills at commit fd6d140, republished under its MIT licence (© seranking). 860 words, ~1,819 tokens.

Download SKILL.mdSave it as .claude/skills/seo-ai-social-report/SKILL.md (or your agent's skills folder).
name
seo-ai-social-report
description
Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a self-contained interactive HTML report. Use this skill whenever the user wants a combined cross-channel report, or says things like "give me a full report across SEO and social", "how did we do this month across search and social", "combined SEO + AI + social report for [client]", "build a cross-channel dashboard", or "one report that covers rankings, AI visibility and social". Always activate when the request spans both search (SE Ranking) and social (Planable) in a single report.

Unified SEO + AI + social report

Most reporting forces clients to read three tools separately. This produces one view: search rankings and AI-search visibility from SE Ranking, social engagement from Planable, with quick text conclusions for the inbox and an interactive HTML report for the detail.

Prerequisites

  • SE Ranking MCP connected (a project gives the cleanest ranking trend; Data API history works without one).
  • Planable MCP connected, with the workspace and connected pages.
  • The user provides: domain + brand, market/country (default us), the Planable workspace, the reporting period (default: previous calendar month), and optionally competitors for share-of-voice.

Connector health check

Before doing anything else, verify both MCPs are reachable:

Only continue to the process steps below once both calls return a successful response.

Process

1. Scope

Confirm domain, Planable workspace, period, and competitors. Resolve the period to explicit start/end dates.

2. Pull SEO (SE Ranking)
  • With a project: PROJECT_getSummary and PROJECT_getPositionHistory(site_id, type: avg_pos | visibility, date_from, date_to) for the ranking trend; optionally reuse a finished audit (PROJECT_listAudits → getAuditReport) for a site-health number.
  • Without a project: DATA_getDomainOverviewWorldwide for the snapshot.
  • Shortcut: the AI overview call in step 3 (time-series view) already returns monthly organic_traffic / overall_traffic streams for the chosen country — you can reuse those for the organic-trend chart instead of a separate history call.
3. Pull AI search (SE Ranking)
  • DATA_getAiSearchOverview(target, source, brand?) with the default time-series view — brand presence, link presence, AI opportunity traffic, average position, plus monthly trend streams (including organic/overall traffic). If previous is null, treat it as a baseline — don't render the change_percent of 100 as growth.
  • DATA_getAiSearchLeaderboard(primary, competitors[], source, engines[]) — share of voice vs competitors (only if competitors were provided). Query it narrowly (few engines/competitors per call) — it can time out on large requests.
4. Pull social (Planable)
  • list_pages(workspaceId) → page IDs.
  • get_page_metrics_summary(workspaceId, pageIds, startDate, endDate) — account-level audience/impressions/engagement-rate.
  • get_post_metrics_summary(workspaceId, pageIds, startDate, endDate) — published-post totals in the window. (Different scope from page impressions — keep them separate.)
  • get_post_metrics(workspaceId, pageIds, ..., limit: 5) — top posts.
  • list_posts(...) — posts published in the period (volume/cadence).
  • For a monthly social trend, call get_page_metrics_summary once per month bucket.
5. Write the quick conclusions (chat)

A ~10–15 line plain-text summary: the headline move in each of the three areas (SEO, AI search, social), then 2–3 specific callouts ("what moved", "what to watch"). This is the part most people actually read — make it sharp and number-led, no filler.

Show full SKILL.md (409 more words)Show less
6. Build the interactive HTML report

Use the bundled template at assets/report-template.html as the starting point — it has the Planable colour palette, the card/section layout, and Chart.js (CDN) wired up, including a dual-axis trend chart. Populate it with the real data you pulled:

  • KPI cards: organic traffic, AI presence / share of voice, social impressions, engagement rate, posts — each with a real period-over-period change where you have one (leave the delta blank otherwise; never invent it).
  • Trend charts (interactive): ranking/organic trend, AI presence trend, social impressions & engagement. When two series have very different scales (e.g. organic traffic in the thousands vs AI opportunity traffic in the hundreds, or impressions vs engagement), plot them on a dual axis or in separate charts — don't squash them onto one axis or the smaller line flatlines.
  • Share of voice: a bar chart of brand vs competitors (omit if no competitors).
  • Top posts and What moved / What to watch — same callouts as the text summary.

Inline the data as JavaScript arrays in the file (no external data files, no localStorage). Save to the outputs folder as {client}-{period}-cross-channel-report.html, then share it with present_files. Validate the inline script parses (a quick node --check-style pass) before presenting.

Output

  1. Quick conclusions — short text summary in chat (the numbers + 2–3 callouts).
  2. Interactive HTML report — self-contained file, presented via present_files, with KPI cards, hoverable trend charts, share-of-voice, and top posts.

Tips

  • Keep the chat summary tight; the HTML is the detailed artefact. Don't duplicate the full report in chat.
  • Label data sources in the report footer (SE Ranking for search/AI, Planable for social) and stamp the generation date and exact date range.
  • Round for readability (48K, 4.2%); never fabricate a trend. If a series has one data point, show the point and skip the trend line.
  • Mark partial periods (e.g. a month-to-date bucket) clearly so a short bar isn't read as a drop.

Edge cases & limits

  • No GA4 / no Looker Studio. This report covers what the two MCPs return — search/AI visibility and social engagement, not cross-channel conversion attribution. State this in the footer.
  • Limited page-level social analytics: Twitter/X, Pinterest, Threads and Google Business Profile typically don't return page-level metrics via the connector — they appear in unsupportedPages; base totals on supported channels and note the rest as "data not available".
  • Thin periods: if little was published or rankings barely moved, say so plainly rather than dramatising noise.
  • No competitors provided: skip the share-of-voice section instead of leaving an empty chart.

© seranking, 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-ai-social-report of seranking/seo-skills.

Open the folder on GitHubat commit fd6d140

Compare with similar skills

SEO AI Social Report 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.

SEO AI Social Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO AI Social Report this skillseranking/seo-skills161—~1.8kAutomated safety check: PassMIT
Blog WriteAgriciDaniel/claude-blog2.3k1 repos~5.6kAutomated safety check: PassMIT
Blog WriteAgriciDaniel/claude-blog2.3k—~5.6kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT

Similar skills

  • Blog Write

    AgriciDaniel/claude-blog

    Write new blog articles from scratch optimized for Google rankings and AI citations.

    2.3k GitHub starsUsed in 1 repo~5.6k tokens
    Writing & ContentAuto-check passed
  • Blog Write

    AgriciDaniel/claude-blog

    Write new blog articles from scratch optimized for Google rankings and AI citations.

    2.3k GitHub stars~5.6k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes

More from seranking/seo-skills

All 32 skills in this repo
  • SEO Google

    seranking/seo-skills

    Direct access to Google's own SEO data via Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, GA4 organic…

    161 GitHub stars~4.8k tokensUpdated 3 mo ago
    Auto-check passed
  • SEO API

    seranking/seo-skills

    SE Ranking API integration architect. An agent skill from seranking/seo-skills.

    161 GitHub stars~4.1k tokensUpdated 3 mo ago
    Auto-check passed
  • SEO Content Audit

    seranking/seo-skills

    E-E-A-T + CITE quality audit for an EXISTING piece of content.

    161 GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • SEO Content Brief

    seranking/seo-skills

    Generate a writer-ready SEO content brief from a target domain and topic.

    161 GitHub stars~2.5k tokensUpdated 3 mo ago
    Auto-check passed
  • SEO Drift

    seranking/seo-skills

    Capture an SEO baseline snapshot for a domain or URL, then on later runs compare the current state and surface regressions.

    161 GitHub stars~3.4k tokensUpdated 3 mo ago
    Auto-check passed
  • SEO Firecrawl

    seranking/seo-skills

    Ad-hoc web scraping, site mapping, and full-site crawling via Firecrawl MCP.

    161 GitHub stars~2.3k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about SEO AI Social Report

What does SEO AI Social Report do?

Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a…. SEO AI Social Report is an agent skill from seranking/seo-skills. Generate one unified performance report that brings together SEO rankings, AI-search visibility (SE Ranking) and social engagement (Planable) — delivered as a short text summary in chat plus a self-contained interactive HTML report.

When should I use SEO AI Social Report?

SEO AI Social Report fits situations like: the user wants a combined cross-channel report; says things like give me a full report across SEO and social; how did we do this month across search and social; combined SEO + AI + social report for [client].

How do I install SEO AI Social Report in Claude Code?

Run `npx skills add seranking/seo-skills --skill seo-ai-social-report -a claude-code`. Or copy the skill folder (skills/seo-ai-social-report in seranking/seo-skills) into .claude/skills/seo-ai-social-report in your project. Claude Code loads it when a task matches its description.

How do I install SEO AI Social Report in Codex?

Run `npx skills add seranking/seo-skills --skill seo-ai-social-report -a codex`. Or copy the skill folder (skills/seo-ai-social-report in seranking/seo-skills) into .agents/skills/seo-ai-social-report in your project. Codex loads it when a task matches its description.

Can I use SEO AI Social Report 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 seranking/seo-skills --skill seo-ai-social-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-ai-social-report, .gemini/skills/seo-ai-social-report, .github/skills/seo-ai-social-report and .opencode/skills/seo-ai-social-report in your project.

What does SEO AI Social Report need to run?

Going by SKILL.md and its folder, SEO AI Social Report needs the command-line tools its instructions call (node).

Does SEO AI Social Report access the network?

SKILL.md names 2 domains. As links in the text: seranking.com and help.planable.io. This is read from the text; nothing was executed.

Is SEO AI Social Report 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 SEO AI Social Report use?

SEO AI Social Report 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 SEO AI Social Report use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 SEO AI Social Report?

Skills that share tags, products or a category with SEO AI Social Report: Blog Write (AgriciDaniel/claude-blog, 2.3k stars), Blog Write (AgriciDaniel/claude-blog, 2.3k stars), Geo Fundamentals (wasp-lang/wasp, 19k stars) and SEO Geo (ReScienceLab/opc-skills, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO AI Social Report?

seranking (a GitHub organization) maintains it in seranking/seo-skills, which has 161 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 25, 2026.

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