repo2psm

Locates the service PSM identifier from repository configuration files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you know a code repository or workspace but not the service PSM it maps to, this Skill finds the PSM by scanning well-known repository files instead of manually grepping through bootstrap scripts. ## Core Features & Use Cases - Repository-to-PSM Resolution: Searches common files in priority order—script/bootstrap.sh (PSM variable), script/settings.py (PRODUCT.SUBSYSTEM.MODULE), build.sh (RUN_NAME), and atum.yaml (PSM field)—to extract the service identifier. - Deterministic Output: Returns the exact PSM string (e.g., tiktok.devflow.api) or an empty string when no PSM can be located, signaling a fallback to manual inspection. - Use Case: You are given a workspace and need to run psm-info, metrics, or argos-query, but those tools require a PSM. Run this Skill first to resolve the repository into its PSM, then proceed with downstream queries. ## Quick Start Find the service PSM for the current repository workspace so I can query its metrics and logs.

Frequently Asked Questions about repo2psm

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

FAQPage Schema
How do I find the PSM of a service from its code repository?

Check common repository files in priority order: script/bootstrap.sh for the PSM variable, script/settings.py for the PRODUCT.SUBSYSTEM.MODULE pattern, build.sh for RUN_NAME, and atum.yaml for the PSM field. This Skill automates that lookup within the current working directory.

What is a PSM and what format does it follow?

A PSM is a unique service identifier in the format PRODUCT.SUBSYSTEM.MODULE, such as tiktok.devflow.api. It is used by internal tools like psm-info, metrics, and argos-query to target a specific service.

What should I do after resolving a repository to its PSM?

Use the PSM with psm-info to view repository, SCM, and deployment region metadata, or pass it to metrics and argos-query for observability data. If a vregion is required but unknown, ask the user directly rather than guessing.

What happens when no PSM is found in the repository?

The Skill returns an empty string when it cannot locate a PSM in any of the known files. In that case, fall back to manually inspecting the repository files for service identifiers.

Does repo2psm determine the deployment region or vregion?

No. This Skill only resolves repository to PSM and does not guess vregion. If downstream queries need a region and the user has not provided one, ask the user directly.