endpoint-validator

Featured

Deterministic API endpoint validation with pass/fail reporting.

API & Backend 412 stars 42 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Endpoint Validator Skill Deterministic HTTP endpoint validation following a **Discover, Validate, Report** pattern. Finds endpoints, tests each against expectations, and produces machine-readable results with clear pass/fail verdicts and CI-compatible exit codes. ## Reference Loading Table | Signal | Load These Files | Why | |---|---|---| | Security header WARNs, HSTS/CSP/X-Frame issues | `security-headers.md` | Routes to the matching deep reference | | Config errors, hardcoded IPs, timeout problems | `endpoint-config-preferred-patterns.md` | Routes to the matching deep reference | | 401/403 failures, Bearer/API-key/cookie auth | `auth-endpoint-patterns.md` | Routes to the matching deep reference | ## Instructions ### Phase 1: DISCOVER **Goal**: Locate or receive endpoint definitions before making any requests. **Step 1: Read repository CLAUDE.md** Check for and follow any repository-level CLAUDE.md before running validation. It may contain base URL conventions, environment variable names, or endpoint paths relevant to the project. **Step 2: Search for endpoint configuration** Look for definitions in priority order: 1. `endpoints.json` in project root 2. `tests/endpoints.json` 3. Inline specification provided by user or calling agent Prefer config files checked into version control over ad-hoc endpoint lists. Manually listing endpoints every run leads to drift and missed endpoints. **Step 3: Parse and validate configuration** Configuration must contain `base_ur...

Details

Author
notque
Repository
notque/vexjoy-agent
Created
4 months ago
Last Updated
2 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

API & Backend Solid

backend-validation

Use this skill when validating a backend API or WebSocket endpoint end-to-end, including acquiring an OIDC bearer token for authenticated calls. Trigger whenever the user asks to test/validate/smoke-check a backend, write a Hurl test, hit a WebSocket, acquire an access token, exercise an OIDC flow, debug a 401, or verify an endpoint works with real auth. Applies to projects that use Hurl for HTTP tests, websocat for WebSocket probes, and oauth2c or curl-based flows for token acquisition (Authentik, Keycloak, Okta, Auth0, any RFC 6749 / OIDC Core provider). Prefer this skill over ad-hoc curl + bash when the user has more than one endpoint to check, chained auth flows, or anything resembling a regression test — because the Hurl + cached-refresh-token pattern is 10× less code and survives the next session.

11 Updated yesterday
johnkozaris
AI & Automation Listed

env-validator

Environment variable consistency validator. Checks GH_* vs GITHUB_* naming conventions, validates documentation matches code, and ensures deployment scripts correctly map secrets. Use proactively when modifying environment variables, updating CLAUDE.md, editing configure-secrets.sh, or changing the Env interface.

51 Updated today
raphaeltm
Code & Development Listed

software-validation

Discover, execute, and report existing repository-native software checks. Use when asked to validate a change, run the repository's established checks against a change or package, run the applicable typecheck, static analysis, lint, format, test, benchmark, load, soak, stress, build, package, documentation, doctest, link, generated-reference, or example checks, or explain what validation evidence is still missing. Do not use to invent or install tooling, design new tests, choose architecture quality targets, prioritize repository improvements, or orchestrate delivery.

0 Updated 2 days ago
sebastian-software