overpass

Retrieve service IDL metadata and trigger Overpass client code generation.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill overpass-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overpass
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/overpass
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill overpass-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you need to call another internal service, you must first find its IDL definition, understand its available methods, and generate client stub code. This Skill automates that entire lookup-and-generate workflow against the Overpass platform, eliminating manual repo digging and codegen configuration. ## Core Features & Use Cases - IDL & Repo Lookup: Query a service's IDL path, repository info, and method list (with AI-generated comments) by PSM name. - Client Code Generation: Trigger Overpass code generation for client stubs with automatic polling until completion, supporting branch, biz line, framework type, and Kitex version selection with three-level fallback. - Project-Level Repo Management: Query, force-refresh, and update branch configurations for project-dimension repos using either repo_name or project_id. - Use Case: You need to call tiktok.user.service from your service. Ask for its method list to pick the right interface, then trigger code generation to get ready-to-use client stubs on the master branch. ## Quick Start Ask the agent to list the IDL methods of the service tiktok.user.service and then generate its Overpass client code on the master branch.

Frequently Asked Questions about overpass

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate client code to call another service with Overpass?

Run the generate_psm_repo action with the target service's PSM name, optionally specifying branch, biz, framework_type, or kitex_version. The action triggers code generation and polls until completion, waiting up to 5 minutes before returning the result.

How do I see what methods a service exposes in its IDL?

Use the get_psm_method_list action with the service's PSM name. It returns the IDL method names, corresponding Go method names, and AI-generated comments describing each method, with an optional branch parameter.

Can I specify a Kitex version for Overpass code generation?

Yes, pass kitex_version to generate_psm_repo with values like v1.20.3, v1.19.4, v1.18.4, v1.15.3, or v1.11.6. If unspecified, it falls back to the PSM's existing platform configuration, then to the platform default.

What is the difference between PSM-dimension and project-dimension actions?

PSM-dimension actions operate on a single service identified by its PSM name, covering IDL info and code generation. Project-dimension actions manage project-level repos and accept either repo_name (fuzzy search) or project_id (exact query), auto-completing the other.

When should I use edit-idl instead of the Overpass skill?

Use edit-idl when you need to modify IDL files themselves. The Overpass skill is read-oriented for IDL metadata and code generation; it retrieves IDL info and triggers codegen but does not edit IDL content.