본문으로 건너뛰기
cccskills
무료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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

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

flexprice/flexprice스타 6,876(GitHub 6,876 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

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

포함된 파일(1)

  • SKILL.md1.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

apitest

무료

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.9천2026년 10월 29일 업데이트

arch

무료

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.9천2026년 10월 29일 업데이트

compose

무료

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.9천2026년 10월 29일 업데이트

context-sync

무료

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.9천2026년 10월 29일 업데이트

devenv

무료

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.9천2026년 10월 29일 업데이트

gh

무료

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.9천2026년 10월 29일 업데이트

flexprice의 스킬 모두 보기

이 스킬의 문제 신고