New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

MCP Apps Sync Docs

by apollographql in apollographql/apollo-mcp-server

Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog.

MITAuto-check passedDevelopment

Install MCP Apps Sync Docs

skills CLI
$ npx skills add apollographql/apollo-mcp-server --skill mcp-apps-sync-docs -a claude-code

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

GitHub CLI
$ gh skill install apollographql/apollo-mcp-server mcp-apps-sync-docs --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/apollographql/apollo-mcp-server.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mcp-apps-sync-docs .claude/skills/mcp-apps-sync-docs && 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
mcp-apps-sync-docs
GitHub stars
311
Token cost
~1.2k tokens
SKILL.md length
537 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog.

  • Works in 6 steps: Fetch the changelog → Parse relevant versions → Read the docs → …
  • The user wants to update
  • SKILL.md covers Overview, What you need from the user, Step 1: Fetch the changelog and Step 2: Parse relevant versions, plus 4 more sections
  • Calls gh

What it does

MCP Apps Sync Docs is an agent skill from apollographql/apollo-mcp-server. Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog. Always use this skill whenever: (1) the user wants to update or sync the mcp-apps-.mdx docs based on a new release or version range, (2) phrases like "sync docs from version X", "update docs from changelog", "what changed since v0.x.x", "docs are out of date", or "check the changelog" appear in context of MCP Apps documentation, (3) checking whether mcp-apps-.mdx files reflect recent releases. The changelog URL and doc file paths are…

Its SKILL.md is about 1.2k 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 Development, covering Markdown, Changelog and release notes and MCP servers. It works with Model Context Protocol, Apollo GraphQL and GraphQL. The licence is MIT.

When your agent uses it

  • The user wants to update
  • Sync the mcp-apps-.mdx docs based on a new release
  • Phrases like sync docs from version X
  • Update docs from changelog

Example prompts

  • “sync docs from version X”
  • “update docs from changelog”
  • “what changed since v0.x.x”
  • “/mcp-apps-sync-docs”

Requirements

  • Pre-approved tools (allowed-tools): Bash(gh api *), Bash(base64 *)

Workflow steps

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

  1. Fetch the changelog
  2. Parse relevant versions
  3. Read the docs
  4. Analyze the changes
  5. Make the edits
  6. Summarize what you did

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(gh api *)
    • Bash(base64 *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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

MCP Apps Sync Docs loads about 1.2k tokens when it runs. Until then it costs about 153 tokens; SKILL.md has 537 words of instructions outside code blocks.

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

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 apollographql/apollo-mcp-server at commit 04e4e6e, republished under its MIT licence (© apollographql). 537 words, ~1,204 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-apps-sync-docs/SKILL.md (or your agent's skills folder).
name
mcp-apps-sync-docs
description
Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog. Always use this skill whenever: (1) the user wants to update or sync the mcp-apps-*.mdx docs based on a new release or version range, (2) phrases like "sync docs from version X", "update docs from changelog", "what changed since v0.x.x", "docs are out of date", or "check the changelog" appear in context of MCP Apps documentation, (3) checking whether mcp-apps-*.mdx files reflect recent releases. The changelog URL and doc file paths are pre-configured — the user only needs to provide the minimum version to sync from.
allowed-tools
Bash(gh api *), Bash(base64 *)
argument-hint
<minimum-version>

Overview

This skill updates the MCP Apps documentation based on changes in the @apollo/client-ai-apps CHANGELOG from a specified version onward. It reads the changelog, compares it against the current docs, and makes targeted edits — without committing.

What you need from the user

One thing: a minimum version (e.g., 0.6.0 or v0.6.2). All changelog entries from that version to the latest will be analyzed.

Step 1: Fetch the changelog

Use the GitHub CLI to fetch the full changelog:

bash
gh api repos/apollographql/apollo-client-ai-apps/contents/CHANGELOG.md --jq '.content' | base64 -d

Step 2: Parse relevant versions

The changelog uses this structure:

## 0.6.5 (2026-03-23)

### Features

#### Feature title

Description and code examples...

### Fixes

#### Fix title

Description...

Collect all version sections where the version number is greater than or equal to the user's minimum version. Ignore everything below that version. Parse each section into: version number, date, list of features, list of fixes, and any breaking changes or deprecations called out explicitly.

Step 3: Read the docs

Read all six documentation files. Understand what each one covers before analyzing the changelog:

  • docs/source/mcp-apps.mdx — MCP Apps overview: what are MCP apps, high-level overview, architecture diagram
  • docs/source/mcp-apps-architecture.mdx — How MCP Apps work: the discovery and tool execution phases, architecture diagrams
  • docs/source/mcp-apps-quickstart.mdx — Step-by-step setup guide using the Apollo AI Apps Template; Vite plugin behavior; project structure
  • docs/source/mcp-apps-development.mdx — Day-to-day development patterns, directives, hooks, and client usage
  • docs/source/mcp-apps-prerequisites.mdx — System and account prerequisites before building
  • docs/source/mcp-apps-reference.mdx — API reference: directives (@tool, @prefetch, @private), hooks (useToolInfo, etc.), manifest, configuration

Step 4: Analyze the changes

For each changelog entry, decide whether a doc change is needed:

Features — Is this already documented? If not, which file is the right home?

  • New hooks, directives, or client APIs belong in mcp-apps-reference.mdx
  • Changes to how Vite plugin builds or generates files belong in mcp-apps-quickstart.mdx or mcp-apps-development.mdx
  • Changes to how the architecture works belong in mcp-apps-architecture.mdx
  • New system requirements belong in mcp-apps-prerequisites.mdx

Deprecations — Are the deprecated APIs mentioned positively in the docs? Add a deprecation notice near the relevant section and point to the replacement.

Breaking changes / behavior changes — Do the docs describe the old behavior as correct? Update them to reflect the new behavior.

Bug fixes — Generally skip these unless the docs explicitly described the buggy behavior as correct (e.g., documented a workaround that is no longer needed).

Show full SKILL.md (184 more words)Show less

Step 5: Make the edits

Edit the affected files directly using available tools. As you do:

  • Match the existing tone, MDX component usage (e.g., <Note>, code fences with language tags), and heading levels
  • Insert new content in the section that makes the most sense contextually, not just at the end of the file
  • For deprecations, add a notice near the existing mention — don't remove the old API from docs until it's actually gone
  • For breaking changes, update the description in place so readers see the current behavior
  • Keep each change minimal and traceable to its changelog entry
  • Write as if the behavior or code was always that way. DO NOT write in past tense (avoid language such as "previously it was x, now it is y")

Do not commit. Leave all edits as unstaged file changes for the user to review.

Step 6: Summarize what you did

Give the user a concise report:

  • Which files were modified
  • For each change: what was updated and which changelog entry it corresponds to
  • Which changelog entries were skipped and why (e.g., "internal fix, no user-facing behavior change")

© apollographql, 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 .agents/skills/mcp-apps-sync-docs of apollographql/apollo-mcp-server.

Open the folder on GitHubat commit 04e4e6e

Compare with similar skills

MCP Apps Sync Docs 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.

MCP Apps Sync Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP Apps Sync Docs this skillapollographql/apollo-mcp-server311—~1.2kAutomated safety check: PassMIT
QA Find Bugs MCPbex-co/beancount-io295—~3kAutomated safety check: PassMIT
Shopify AI Toolkit Wrapperjeremylongshore/tons-of-skills-marketplace2.8k—~1.5kAutomated safety check: PassMIT
Build Error AdapterArcadeAI/arcade-mcp1k—~2kAutomated safety check: PassMIT
Unraiddinglebear-ai/unraid135—~5.4kAutomated safety check: NotesMIT
SpikardGoldziher/spikard123—~799Automated safety check: PassMIT

Similar skills

  • QA Find Bugs MCP

    bex-co/beancount-io

    Hunt bugs in the Beancount.io remote MCP server by driving the real POST /api-gateway/mcp endpoint with JSON-RPC and real MCP clients, checking transport, discovery, credential boundaries, tool and…

    295 GitHub stars~3k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Shopify AI Toolkit Wrapper

    jeremylongshore/tons-of-skills-marketplace

    Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search.

    2.8k GitHub stars~1.5k tokensUpdated today
    Backend & APIsAuto-check passed

  • Build Error Adapter

    ArcadeAI/arcade-mcp

    Build new Arcade error adapters from scratch using public Arcade TDK patterns.

    1k GitHub stars~2k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Unraid

    dinglebear-ai/unraid

    This skill should be used when the user mentions Unraid, asks to check server health, monitor array or disk status, list or restart Docker containers, start or stop VMs, read system logs, check…

    135 GitHub stars~5.4k tokensUpdated 4 days ago
    DevOps & CloudAuto-check: notes

  • Spikard

    Goldziher/spikard

    Scaffold Spikard projects and generate code from OpenAPI, AsyncAPI, OpenRPC, GraphQL, and Protobuf schemas using the Spikard CLI or its MCP server.

    123 GitHub stars~799 tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

  • Unraid

    dinglebear-ai/unraid

    Query and monitor an Unraid NAS/homelab server — array health, disk temperatures, Docker containers, virtual machines, system metrics, notifications, alerts, shares, UPS status, log files, network…

    135 GitHub stars~2.8k tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed

More from apollographql/apollo-mcp-server

  • Review

    apollographql/apollo-mcp-server

    Review a GitHub pull request for a Rust codebase. An agent skill from apollographql/apollo-mcp-server.

    311 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about MCP Apps Sync Docs

What does MCP Apps Sync Docs do?

Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog. MCP Apps Sync Docs is an agent skill from apollographql/apollo-mcp-server. Syncs MCP Apps documentation with the @apollo/client-ai-apps changelog.

When should I use MCP Apps Sync Docs?

MCP Apps Sync Docs fits situations like: the user wants to update; sync the mcp-apps-.mdx docs based on a new release; phrases like sync docs from version X; update docs from changelog.

How do I install MCP Apps Sync Docs in Claude Code?

Run `npx skills add apollographql/apollo-mcp-server --skill mcp-apps-sync-docs -a claude-code`. Or copy the skill folder (.agents/skills/mcp-apps-sync-docs in apollographql/apollo-mcp-server) into .claude/skills/mcp-apps-sync-docs in your project. Claude Code loads it when a task matches its description.

How do I install MCP Apps Sync Docs in Codex?

Run `npx skills add apollographql/apollo-mcp-server --skill mcp-apps-sync-docs -a codex`. Or copy the skill folder (.agents/skills/mcp-apps-sync-docs in apollographql/apollo-mcp-server) into .agents/skills/mcp-apps-sync-docs in your project. Codex loads it when a task matches its description.

Can I use MCP Apps Sync Docs 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 apollographql/apollo-mcp-server --skill mcp-apps-sync-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-apps-sync-docs, .gemini/skills/mcp-apps-sync-docs, .github/skills/mcp-apps-sync-docs and .opencode/skills/mcp-apps-sync-docs in your project.

What does MCP Apps Sync Docs need to run?

Going by SKILL.md and its folder, MCP Apps Sync Docs needs the command-line tools its instructions call (gh). Its frontmatter pre-approves these tools: Bash(gh api *), Bash(base64 *).

Does MCP Apps Sync Docs access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is MCP Apps Sync Docs 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 MCP Apps Sync Docs use?

MCP Apps Sync Docs 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 MCP Apps Sync Docs use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 MCP Apps Sync Docs?

Skills that share tags, products or a category with MCP Apps Sync Docs: QA Find Bugs MCP (bex-co/beancount-io, 295 stars), Shopify AI Toolkit Wrapper (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Build Error Adapter (ArcadeAI/arcade-mcp, 1k stars) and Unraid (dinglebear-ai/unraid, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Apps Sync Docs?

apollographql (a GitHub organization) maintains it in apollographql/apollo-mcp-server, which has 311 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 7, 2026.

Source: apollographql/apollo-mcp-server on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.