CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/pothos-builder-tests

Wraps Pothos GraphQL schema-builder testing patterns: testing the SchemaBuilder output (lexicographicSortSchema + printSchema for snapshot tests), testing resolvers via the standard `graphql()` function from graphql-js (no server needed), integration with Apollo Server / GraphQL Yoga (Pothos emits standard graphql-js schemas), and code-first builder unit tests. Covers the SchemaBuilder API surface (queryType, mutationType, objectType, t.field, t.arg). Use when testing a Pothos-built schema before or alongside the server-runtime tests.

77

Quality

97%

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

Overview
Quality
Evals
Security
Files

Quality

Content

92%

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

A tight, highly actionable testing recipe with executable code, explicit validation feedback loops, and a useful anti-patterns checklist. The main weakness is progressive disclosure: everything lives inline in one file with no reference files to offload advanced material.

Suggestions

Move the advanced plugin-contract and context-required resolver test sections into a reference file (e.g. references/ADVANCED.md) and link to it from SKILL.md so the body stays a concise overview.

Extract the full Apollo Server / GraphQL Yoga integration examples into references/INTEGRATION.md, replacing the inline stub blocks with a clearly signaled 'See INTEGRATION.md' link.

Add a one-level-deep reference (e.g. references/EXAMPLES.md) for the per-domain snapshot and plugin-combination guidance, keeping SKILL.md as a navigable entry point.

DimensionReasoningScore

Conciseness

The body is lean and code-forward, assuming Claude's competence — e.g. "graphql() from graphql-js executes against the schema directly. No server. No HTTP. No middleware." It avoids explaining concepts Claude already knows (no "what is GraphQL" preamble) and every section earns its tokens. Not score 2 because there is no padded or unnecessary explanation to tighten.

3 / 3

Actionability

Provides fully executable, copy-paste-ready TypeScript (SchemaBuilder setup, graphql() unit test, printSchema snapshot, Apollo/Yoga wiring, relay plugin, context-value tests) plus concrete commands (npm install --save-dev, npm test -- --updateSnapshot, CI yaml). Matches the score-3 anchor and exceeds the pseudocode/incomplete score-2 anchor.

3 / 3

Workflow Clarity

A clear topical progression (Install → Build schema → Unit-test resolver → Snapshot → Integration → Running → CI) with explicit validation feedback loops: the snapshot "fails and reviewers see the diff" and CI "--ci flag prevents --updateSnapshot and fails on mismatch", plus an anti-patterns table acting as a checklist. Not score 2 because validation checkpoints and error-recovery guidance are present rather than missing.

3 / 3

Progressive Disclosure

Well-organized into clear sections with a signaled References list, but the entire skill is a single inline file with no one-level-deep reference files (references/scripts/assets do not exist) and advanced material (plugin-contract and context-required tests) that could be split is inline. This fits the score-2 anchor (some structure, content that should be separate is inline) rather than the score-3 anchor requiring well-signaled separate reference files.

2 / 3

Total

11

/

12

Passed

Description

100%

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 strong, specific description that clearly states what the skill does and when to use it, with concrete named primitives and an explicit trigger clause. It carves out a distinct niche and is unlikely to conflict with sibling runtime-testing skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with named primitives — "testing the SchemaBuilder output (lexicographicSortSchema + printSchema for snapshot tests)", "testing resolvers via the standard graphql() function", "integration with Apollo Server / GraphQL Yoga", and "code-first builder unit tests". This matches the score-3 anchor (multiple specific concrete actions) and exceeds the score-2 anchor, which only names a domain and some actions without this breadth.

3 / 3

Completeness

Explicitly answers both what (the four testing patterns plus the SchemaBuilder API surface) and when via an explicit "Use when testing a Pothos-built schema before or alongside the server-runtime tests" clause. This is the score-3 anchor (clearly both what AND when with explicit triggers), not score 2 where when is only implied.

3 / 3

Trigger Term Quality

Covers natural terms a Pothos user would actually say — "Pothos", "GraphQL", "schema-builder", "snapshot tests", "resolvers", "Apollo Server", "GraphQL Yoga", "testing" — and the explicit trigger "Use when testing a Pothos-built schema". Not score 2 because common variations are present rather than merely "some relevant keywords".

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (Pothos code-first schema-builder testing) with distinct triggers and explicitly distinguishes sibling runtimes (apollo-server-tests, graphql-yoga-tests) as separate skills. Unlikely to trigger for the wrong skill, matching the score-3 anchor rather than the overlapping score-2 anchor.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents