CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

graphql-audit

GraphQL security hunting — introspection abuse, field suggestion enumeration (clairvoyance), batching DoS, IDOR via aliasing, auth bypass, injection via arguments, subscription abuse, depth/complexity bombs, and WAF bypass. Covers graphw00f fingerprinting, GraphQLmap, graphql-cop, and inql. Use when a target exposes a /graphql, /api/graphql, or GQL-over-HTTP endpoint.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

An aggressive, highly actionable audit playbook whose commands are copy-paste ready and whose sequence and abort criteria are clear. Its main structural weakness is that it is a monolithic 520-line SKILL.md with zero progressive disclosure — reference material (full introspection query, report template, tool install notes) is inlined rather than split into bundle files — and install warnings are repeated across sections.

Suggestions

Split reference material into bundle files (e.g., references/introspection-query.md, references/report-template.md, references/tools.md) and keep SKILL.md as the checklist plus one-level-deep, clearly signaled pointers.

Consolidate the PyPI install-safety warnings, which are repeated in sections 6, 10, 11, and the tools table, into a single install note to save tokens.

Add an explicit validation loop after high-impact probes (e.g., re-confirm a suspected IDOR with a second object ID, or re-measure batching timing with a baseline before reporting DoS) to strengthen workflow checkpoints.

DimensionReasoningScore

Conciseness

The body is almost entirely operational — copy-paste curl/python commands, checklists, and tables with no tutorials on concepts Claude already knows. It is not a 5 because there is repeated material that could be trimmed: the PyPI install warnings appear in sections 6, 10, 11, and again in the tools table, and the report template with example titles runs long. This matches 'efficient; minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

Nearly every section gives fully executable, copy-paste-ready commands (curl probes, python3 one-liners for alias/depth bombs, exact clairvoyance/graphql-cop/wscat invocations) with concrete expected outputs and severity/CVSS guidance. Placeholders like VICTIM_TOKEN are clearly task-inherent, matching the top anchor for copy-paste ready commands covering the common cases.

5 / 5

Workflow Clarity

The 'Quick Kill Checklist' opens with a sequenced plan, sections follow the natural audit order, decision branches exist ('If introspection off — run clairvoyance', 'When __schema is blocked, try:'), and 'KILL SIGNALS' plus the report template's 'confirm impact' step provide checkpoints. It falls short of a 5 because there is no explicit validate-findings-then-retry loop (e.g., verifying a suspected IDOR/DoS result before escalating), matching 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

There is good section structure (14 numbered, clearly headed sections plus a tools table), but the skill is a ~520-line single file with no references/ bundle at all — everything is inline. Content that clearly belongs in separate files is inlined, notably the full introspection query, the chaining/report templates, and the per-tool install details; this matches 'some structure but could be better organized; content that should be separate is inline'.

3 / 5

Total

16

/

20

Passed

Description

100%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 model description: third-person voice, dense with specific attack capabilities and named tools, and an explicit 'Use when' clause with concrete endpoint triggers. Both what and when are unambiguous, and it occupies a distinct niche with essentially no overlap risk.

DimensionReasoningScore

Specificity

The description enumerates many concrete capability areas — 'introspection abuse, field suggestion enumeration (clairvoyance), batching DoS, IDOR via aliasing, auth bypass, injection via arguments, subscription abuse, depth/complexity bombs, and WAF bypass' — plus specific tool coverage ('graphw00f fingerprinting, GraphQLmap, graphql-cop, and inql'). This matches the anchor for multiple specific concrete actions with comprehensive coverage; it is well above the 'several specific actions; minor gaps' anchor.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' is the enumerated attack list with tools, and the 'when' is a literal trigger clause — 'Use when a target exposes a /graphql, /api/graphql, or GQL-over-HTTP endpoint.' This clearly matches the top anchor for explicit what and when with concrete trigger phrases, and exceeds the anchor where 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural trigger terms are comprehensively covered for this niche: 'GraphQL', 'GQL', '/graphql', '/api/graphql', and 'GQL-over-HTTP' — synonyms plus the endpoint-path equivalents of file extensions, paralleling the top anchor. A user needing this skill would naturally mention a GraphQL endpoint; nothing significant is missing.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (GraphQL security testing) with distinct triggers tied to GraphQL endpoint exposure, so it would not fire for general web-app, API, or PDF-type skills. Minimal conflict risk, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

20

/

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

skill_md_line_count

SKILL.md is long (528 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

Awarexone/Agentic-Bug-Hunter

Path

skills/graphql-audit/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.