Skip to content
cccskills
FreePublished on GitHub

openapi

Use this skill to maintain FlexPrice’s OpenAPI specification and generated SDK or MCP tooling. It explains the generation and validation sequence, where custom code belongs, and when an API-only update may not require regenerating every client.

OriginalShow the original description

Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP.

flexprice/flexprice6,876 stars(GitHub 6,876 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Updating the OpenAPI spec after route changes
  • Generating SDKs and MCP tooling
  • Validating an OpenAPI change
  • Keeping custom code through regeneration

Files included (1)

  • SKILL.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

openapi — OpenAPI & SDKs

Source of truth

  • Handlers: Swagger comments in internal/api/**.
  • Generated specs: docs/swagger/ (run generation — do not hand-edit JSON as primary source).

Standard sequence

After route or Swagger annotation changes:

make swagger
make sdk-all

make sdk-all (per AGENTS.md) validates, generates SDKs/MCP, merges api/custom/**.

OpenAPI-only validation:

make speakeasy-validate

Custom vs generated

  • Do not put long-lived custom logic only in generated trees under api/go, api/typescript, api/python, api/mcp.
  • Put custom code in api/custom/<lang>/ and rely on make merge-custom (often part of sdk-all).

MCP tooling

Filtered spec and allowed tags live under .speakeasy/mcp/ — changing exposed tools requires config update + regenerate flow documented in AGENTS.md.

When to skip full sdk-all

Small internal-only HTTP tweak with no exported contract change: make swagger alone may suffice; coordinate with reviewers if public SDK repos are consumers.

Related

  • Tests after API change: expand handler tests or api/tests if behavior is user-facing SDK contract.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

apitest

FreeSummary

Run local HTTP API checks with a staged workflow: confirm the environment, gather credentials interactively, probe endpoints with curl, and record status codes and response excerpts. For large suites, it can divide independent endpoint groups among workers and merge their results.

  • Smoke-checking a local API
  • Testing authenticated endpoints with curl
  • Organizing checks across many endpoints
flexprice/flexprice6.9KUpdated Oct 29, 2026

arch

FreeSummary

Navigate FlexPrice’s codebase using its architecture maps, dependency graphs, hotspot notes, and flow documents. Trace a feature across layers and async systems, assess likely change impact, and identify documentation that should be updated after structural edits.

  • Getting oriented in the FlexPrice codebase
  • Tracing a feature across code layers
  • Assessing impact before a refactor
flexprice/flexprice6.9KUpdated Oct 29, 2026

compose

FreeSummary

Use this skill to set up or manage FlexPrice’s local Docker environment. It provides commands to start and stop services, launch Kafka UI, and follow application logs while troubleshooting.

  • Setting up the local development environment
  • Starting or stopping FlexPrice services
  • Opening Kafka UI during development
flexprice/flexprice6.9KUpdated Oct 29, 2026

context-sync

FreeSummary

Use this skill to check whether repository AGENTS.md context files have fallen behind code changes. It compares tracked file ownership with Git revisions, prepares focused update bundles for affected layers, and advances sync markers after the context is updated.

  • Checking whether AGENTS.md files are stale
  • Refreshing context after code changes
  • Updating one layer’s context file
flexprice/flexprice6.9KUpdated Oct 29, 2026

devenv

FreeSummary

Plan a local development setup by mapping which services run in Docker Compose and which use hosted endpoints such as RDS or managed Kafka. The skill guides environment configuration, service checks, migrations, and choosing an application mode.

  • Preparing a hybrid local and hosted development setup
  • Starting an API, consumer, or Temporal worker locally
  • Checking environment settings before migrations
flexprice/flexprice6.9KUpdated Oct 29, 2026

gh

FreeSummary

Use the GitHub CLI to review pull requests and issues, inspect CI check results and failed logs, and prepare a pull request with a summary and test plan. The skill also outlines the repository review steps before creation.

  • Reviewing a pull request or issue from the CLI
  • Finding the cause of a failed CI check
  • Preparing and creating a pull request
flexprice/flexprice6.9KUpdated Oct 29, 2026

See all skills by flexprice

Report a problem with this skill