Skip to content
Skills Library
Security · Review & audit

api-schema-security

/api-schema-security

Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.

Repository
Claude-Blue ↗
Licence
MIT
Last repository change
01.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 01.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.

Original author description

Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.

How it works

  1. Lint
  2. Checklist
  3. Enforce at runtime
  4. Related skills
  5. References
Original SKILL.md headings · 44 lines, 229 words
SKILL.md preview
---
name: api-schema-security
description: Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.
license: MIT
metadata:
  category: api-security
  version: "2.0.0"
  verification: documented
---

# API Schema Security

## Lint

```sh
npx @stoplight/spectral-cli lint openapi.yaml --ruleset .spectral.yaml
```
`.spectral.yaml`:
```yaml
extends:
  - spectral:oas
  - https://unpkg.com/@stoplight/spectral-owasp-ruleset/dist/ruleset.mjs
```
The OWASP ruleset flags missing security schemes, HTTP servers, unbounded strings/arrays, missing rate-limit headers, numeric IDs, and more. 42Crunch and similar tools provide commercial audits.

## Checklist

| Area | Check |
|---|---|
| AuthN | Global `security` requirement; no operation with `security: []` unless intentionally public |
| Schemas | `additionalProperties: false` on request bodies (prevents mass assignment), `maxLength`/`pattern`/`format` on strings, `maxItems` on arrays, numeric `minimum/maximum` |
| Identifiers | Prefer non-sequential IDs; never rely on them for authorization |
| Responses | Explicit response schemas; no internal fields (hashes, internal IDs, tokens) |
| Pagination | Enforced max page size |
| Servers | `https://` only; no internal hostnames in public specs |
| Errors | Generic error schema without stack traces |
| GraphQL | Disable introspection in production (or restrict), query depth/complexity limits, per-field authorization, persisted queries for public clients |

## Enforce at runtime

Gateway request validation against the spec (Kong/Apigee/AWS API Gateway request validators, Envoy/OPA policies, framework validators like FastAPI/pydantic, express-openapi-validator) — reject unknown fields and invalid types before business logic.

## Related skills

`api-inventory`, `api-authorization-testing`, `release-gate`

## References

- OWASP API Security Top 10 2023: https://owasp.org/API-Security/editions/2023/en/0x11-t10/
- Spectral: https://github.com/stoplightio/spectral
- Spectral OWASP ruleset: https://github.com/stoplightio/spectral-owasp-ruleset
- OWASP GraphQL Cheat Sheet: https://cheatsheetseries.owasp.org/cheatsheets/GraphQL_Cheat_Sheet.html

Versions

The database has no other skills named api-schema-security.

Database snapshot: 13.11.2026 · package version c5af5d6c7395 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100api-security-review
    Review OpenAPI specs, GraphQL schemas and API endpoint code against the OWASP API Security Top 10 (2023), covering BOLA, broken auth, mass assignment and data exposure, rate limits and pagination caps, BFLA, SSRF, misconfiguration and API inventory, using Spectral with the OWASP…
  • 100validating-api-schemas
    Validate API schemas against OpenAPI, JSON Schema, and GraphQL specifications. Use when validating API schemas and contracts. Trigger with phrases like "validate API schema", "check OpenAPI spec", or "verify schema".
  • 100validating-api-schemas
    Validate API schemas against OpenAPI, JSON Schema, and GraphQL specifications. Use when validating API schemas and contracts. Trigger with phrases like "validate API schema", "check OpenAPI spec", or "verify schema".
  • 90api
    Security lens for REST and GraphQL APIs. Use on any task touching an OpenAPI/Swagger spec, GraphQL schema, route handler, auth middleware or API gateway config, and when the user says "bloodhound", "API security", "is this endpoint safe". Static, defensive use only.
  • 100owasp-api-security-top-10-hardening
    Use this skill when harden REST and GraphQL APIs against the OWASP API Security Top 10 vulnerabilities.
  • 100api-audit
    Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023). Use when the user mentions 'API security,' 'API audit,' 'BOLA,' 'broken object level authorization,' 'BFLA,' 'function-level authorization,' 'mass assignment,' 'API rate limiting,' 'GraphQL…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.