Agent skill
http-api-openapi
Keep HTTP handlers and OpenAPI (openapi.yaml) in sync. Use when adding/changing endpoints, request/response schemas, auth requirements, or error shapes.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/http-api-openapi
Metadata
Additional technical details for this skill
- repo
- mjrwtf
- runner
- github-copilot-cli
- version
- 1.2
SKILL.md
Tooling assumptions
- Use a terminal runner with bash and git available.
- Prefer
maketargets when available; fall back to direct CLI commands when needed.
Source of truth
- OpenAPI spec:
openapi.yamlat the repo root.
Typical workflow
- Update
openapi.yaml(paths, schemas, auth). - Validate the spec:
bash
make validate-openapi
If swagger-cli isn’t installed:
bash
npm install -g @apidevtools/swagger-cli
- Implement the handler changes in Go (and keep auth consistent with the spec).
- Run tests:
bash
make test
Project-specific notes
- Authenticated endpoints use Bearer token auth (see README’s Auth section).
- Be explicit about error responses and status codes in the spec when behavior changes.
Didn't find tool you were looking for?