graphql-expert SKILL.md skillA
graphql-expert from seaworld008/commonly-used-high-value-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add seaworld008/commonly-used-high-value-skills/graphql-expert@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- seaworld008/commonly-used-high-value-skills
- Path
openclaw-skills/graphql-expert/SKILL.md- Versions recorded
- 5
- Latest version
- v1.0.0, committed Jun 29, 2026
- First version recorded
- Mar 27, 2026
- Size
- 5,247 bytes
- Repository stars
- 73
- License
- MIT
Use when designing GraphQL APIs, reviewing schemas and resolvers, optimizing queries, managing federation, or checking GraphQL security and performance best practices.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# GraphQL Expert ## 触发条件 - 当需要设计现代、高效的 Web/Mobile API，且 REST API 面临“Over-fetching”或“Under-fetching”问题时。 - 在构建具有复杂关联关系的数据模型（如社交网络、电商平台）时。 - 需要在多个微服务之上构建统一的数据聚合层（Federation/Gateway）时。 - 系统对实时通信有需求，需要使用 WebSocket 实现 GraphQL Subscriptions 时。 - 需要在同一个 API 端点支持多个版本的客户端，且不希望频繁变更 API 路径时。 ## 核心能力 ### 1. Schema 设计哲学 (Design Paradigms) - **Schema-first**: 优先定义 SDL (Schema Definition Language)。便于前后端并行开发，利于契约化管理。 - **Code-first**: 根据代码自动生成 Schema。减少定义冗余，提升类型安全（如 TypeScript + GraphQL Nexus）。 - **字段细粒度控制**: 遵循“单一职责”原则定义每一个 Query 和 Mutation 字段。 - **Scalar 类型扩展**: 自定义 Date, Email, BigInt 等自定义标量，增强校验能力。 ### 2. 高级查询与 Resolver 模式 - **Resolver 分层**: 业务逻辑与数据获取逻辑分离，保持 Resolver 的简洁性。 - **N+1 问题详解**: - 传统 Resolver 在循环查询关联对象时会发起大量重复数据库调用。 - **解决方案**: 使用 DataLoader。通过对请求进行批处理（Batching）和缓存（Caching），将 $N+1$ 次查询合并为 1-2 次。 - **异步处理**: Resolver 全面采用 Promise/Async-await 模式，支持并发数据抓取。 ### 3. 分页与数据导航 (Pagination) - **Offset Pagination**: 适用于简单的列表，支持随机访问。缺点是大数据量下数据库 `OFFSET` 性能低下。 - **Cursor-based Pagination (Relay Spec)**: 使用 `edges`, `node`, `pageInfo` 结构。推荐用于大数据量和无限滚动场景，具有卓越的数据库查询性能。 - **Connection 规范**: 统一化所有分页字段的命名习惯，便于前端通用组件复用。 ### 4. 实时性与性能优化 (Performance & Real-time) …
Read the whole file at its exact version.
How to install
mdr add seaworld008/commonly-used-high-value-skills/graphql-expert@sha256:16016d2a6375c885The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_w7aypofu7eauhbq6)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Mar 27, 2026 and Jun 29, 2026, about one every 23 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-06-29 | eafe326 | 5,247 B | A | view · diff |
| v1.0.0 | 2026-04-18 | c0657a9 | 5,103 B | A | view · diff |
| v1.0.0 | 2026-04-18 | c220260 | 5,120 B | A | view · diff |
| v1.0.0 | 2026-03-27 | 0b34652 | 5,083 B | A | view · diff |
| git:20260327.4dd132e | 2026-03-27 | 4dd132e | 4,876 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5247 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
seaworld008/commonly-used-high-value-skills · 73 stars · license MIT · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_w7aypofu7eauhbq6 GET https://markdownregistry.com/api/v1/resolve?ref=seaworld008/commonly-used-high-value-skills/graphql-expert GET https://markdownregistry.com/api/v1/blob/16016d2a6375c885eae6f069c53616c66463d6390637d91c10fbf4054041cf2f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from seaworld008/commonly-used-high-value-skills
Every file in seaworld008/commonly-used-high-value-skills