CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

graphql-architect

Master modern GraphQL with federation, performance optimization, and enterprise security. Build scalable schemas, implement advanced caching, and design real-time systems.

Quality

44%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/graphql-architect/SKILL.md

The canonical home for this skill is graphql-architect in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

10%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body reads as a persona/résumé document rather than an operational skill: it enumerates topic areas Claude already knows while providing no executable guidance, no code, no concrete decision rules, and no real validation checkpoints. Its single reference to detailed material points to a file that is absent from the bundle, making the skill effectively non-actionable as written.

Suggestions

Replace the topic-name catalogs (Capabilities, Behavioral Traits, Knowledge Base) with concrete, decision-oriented guidance — e.g., actual SDL snippets for federation entities, a DataLoader wiring example, and specific field-level authorization patterns — or move them into real reference files.

Fix progressive disclosure: create the referenced `resources/implementation-playbook.md` (or repoint to an existing file under references/), and split the bulk of the inlined catalogs into one-level-deep reference files that SKILL.md links explicitly.

Turn the abstract "Response Approach" phases into an executable workflow with concrete steps and verification checkpoints, such as running schema composition checks, query complexity analysis, and resolver-level tests before declaring a design complete.

DimensionReasoningScore

Conciseness

The ~170-line body is almost entirely enumeration of topic names Claude already knows ("DataLoader pattern implementation for N+1 problem resolution", "JWT integration and token validation", "Event sourcing and CQRS pattern implementation") with no added specifics, decisions, or guidance. It is heavily padded in the sense of anchor 1 — nearly no token earns its place — and it cannot score 2 because there is no efficient core hiding underneath the padding.

1 / 5

Actionability

There is no code, no command, no configuration, and no concrete decision rule anywhere; the body only describes ("Configure caching and security", "Implement efficient resolvers"). The sole pointer to detail — "If detailed examples are required, open `resources/implementation-playbook.md`" — references a file that does not exist in the bundle, so it provides no executable guidance at all. This squarely matches anchor 1 (only describes rather than instructs).

1 / 5

Workflow Clarity

The "Response Approach" section lists a rough sequence ("Analyze business requirements", "Design scalable schema", ... "Plan for evolution"), but the steps are abstract phase names with no concrete actions, no inputs/outputs, and no validation checkpoints — "validate outcomes" appears only as a vague instruction. This fits anchor 2 (rough sequence present, steps poorly defined, validation absent) and falls short of anchor 3 because the steps are labels rather than executable operations with any testable checkpoints.

2 / 5

Progressive Disclosure

The capability catalogs (10 sections of topic bullets), behavioral traits, and knowledge base are exactly the detail content that belongs in separate reference files, yet all of it is inlined in SKILL.md (anchor 2: content that clearly belongs in separate files is inlined). Additionally, the only reference in the body points to `resources/implementation-playbook.md`, which does not exist, and no references/, scripts/, or assets/ directories are present in the bundle. It is above anchor 1 because the body does have section headers and is navigable, but it is below anchor 3 because the one reference is broken and nothing is appropriately split out.

2 / 5

Total

6

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A middling description: it names the GraphQL domain and several plausible capabilities, but leans on buzzwords, offers no concrete verifiable actions, and entirely lacks a "Use when..." trigger clause, which both weakens completeness and leaves it relying on the bare keyword "GraphQL" for triggering.

Suggestions

Replace buzzword phrasing ("Master modern GraphQL", "enterprise security") with specific concrete actions such as "Design federated schemas with Apollo Federation 2, resolve N+1 queries with DataLoader, and implement field-level authorization".

Append an explicit trigger clause, e.g. "Use when the user asks about GraphQL schema design, federation/subgraphs, query performance (N+1, caching), or GraphQL API security".

Add natural synonyms and variations users actually say — subgraph, gateway, resolver, subscriptions, schema stitching — to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the GraphQL domain and a few actions ("Build scalable schemas, implement advanced caching, and design real-time systems"), but the actions are generic and diluted by buzzword padding ("Master modern GraphQL", "enterprise security"). This matches the anchor for naming a domain with 1-2 concrete actions without comprehensive coverage, and falls short of the several-specific-actions anchor because nothing is stated at a concrete, verifiable level.

3 / 5

Completeness

The "what" is stated clearly (schema design, caching, real-time system design) but there is no "Use when..." clause or any equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It cannot score 4 because the "when" is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Contains some natural keywords users would say ("GraphQL", "federation", "caching", "schema") but misses common variations and synonyms such as subgraph, gateway, resolver, N+1, subscriptions, or .graphql. Anchor 3 ("Some relevant keywords but missing common variations or synonyms") is the best fit; it is above anchor 2 because the domain keyword itself is natural and specific, but below anchor 4 because coverage is thin.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear GraphQL niche that is mostly distinct, with only minor overlap risk against closely related skills such as general API design or backend architecture skills. Not 5 because phrases like "performance optimization" and "enterprise security" are not unique to GraphQL and could pull in adjacent skills.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/graphql-architect/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.