Agent skill · Dev tools · apollographql

graphos-factory agent skill by apollographql

Builds and maintains an Apollo Connectors subgraph from a REST API in a git workspace, recording design decisions and verification evidence.

View on GitHub Read SKILL.md

At a glance

PublisherApollo GraphQL Official
Repositoryapollographql/skills (15 listed skills)
CategoryDeveloper Tools and Frameworks
LicenseMIT
Last commitOctober 13, 2026 (repository)
SKILL.md444 lines, 8,476 words
Bundled files31 files, including references, scripts
Quality score79/100 · C Passes all seven graded checks
Security scanNot scanned
README badgeGet the listing badge and raise the score

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

Install graphos-factory

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

Skills CLI
npx skills add https://github.com/apollographql/skills/tree/main/skills/graphos-factory
Claude Code, project-level copy
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/apollographql/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/graphos-factory .claude/skills/
rm -rf "$tmp"
Codex installer
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo apollographql/skills \
    --path skills/graphos-factory

apollographql/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Build and iterate on an Apollo Connectors subgraph for a GraphOS supergraph from a REST API, with or without an OpenAPI or Swagger spec, in a dedicated git workspace that records what the API offers, the user's operation and field selection, every design decision, and the evidence each verification layer produced. Use whenever the user wants to wrap a REST API as a GraphQL subgraph for their supergraph, add or remove operations or fields from an existing connector subgraph, refresh one against a new spec, or record live API traffic as test fixtures, even if they do not say "connector", "subgraph" or "Apollo".

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Compatibility, from SKILL.md

CompatibilitymacOS or Linux (WSL on Windows) with bash, curl, git and jq; Java 17+ for the end-to-end and live layers. Any Agent Skills host (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and others)…

Sections in SKILL.md

Files in the skill folder

Showing 24 of 31 files. Browse the folder on GitHub.

Suede Skill Check: 79/100 · C

Report snapshot · · graded-v2

The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.

Source revision: aafc8944365a. Report version d4a4ec1bf515. Badge URLs follow the latest listing; save the report to keep this version.

Download report · Request a fresh review

What to review next

  • Instruction depth: 1 of 7 points. 7 for a SKILL.md body of 500–3,000 words; 4 for 250–4,500; 1 for 100 or more.
  • Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
  • Description length: 3 of 5 points. 5 for 150–600 characters; 3 for 100–900; 1 for 50–1,024.

Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.

graphos-factory passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

See the checks and points
CheckResult
Frontmatter parses and declares a name and a descriptionPass
Name uses lowercase letters, digits and hyphens, 64 characters or fewerPass
Name matches the skill's folder namePass
Description is between 50 and 1,024 charactersPass
Description says when an agent should use the skillPass
SKILL.md body is 500 lines or fewerPass
A license is declared in the frontmatter or the repositoryPass
Repository has a commit in the last 12 monthsPass
Score componentPoints
Structural checks56 of 56
Description length3 of 5
Boundary clause0 of 4
Example request3 of 3
Instruction depth1 of 7
Reference files3 of 3
Bundled scripts2 of 2
Recent maintenance9 of 9
Curated-list citations0 of 7
Tool permissions declared0 of 2
Compatibility declared2 of 2

Show the listing and raise the score

graphos-factory is listed with 79/100 · C. This badge links to its Suede listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for graphos-factory are instruction depth (6), boundary clause (4) and description length (2). Send your repository and the points you want to raise, then request a fresh review after updating the skill.

Suede Skills Directory: listed

Markdown
[![Suede Skills Directory: listed](https://skills.suedeai.ai/directory/badge.svg)](https://skills.suedeai.ai/directory/apollographql/skills/graphos-factory/)
HTML
<a href="https://skills.suedeai.ai/directory/apollographql/skills/graphos-factory/"><img src="https://skills.suedeai.ai/directory/badge.svg" alt="Suede Skills Directory: listed" height="20"></a>

Where this skill is cited

apollographql/skills is listed from its publisher's official collection or a listing request.

ax-repoNecmttn/ax terminal-titlebluzername/claude-code-terminal-title expo-data-fetchingexpo/skills provider-ephemeral-resourceshashicorp/agent-skills using-email-templatesmailtrap/mailtrap-skills react-emailresend/resend-skills

All developer tools and frameworks skills

More from apollographql/skills

apollo-clientapollographql/skills apollo-connectorsapollographql/skills apollo-federationapollographql/skills apollo-iosapollographql/skills apollo-kotlinapollographql/skills apollo-routerapollographql/skills

All 15 skills in apollographql/skills