Skip to main content
POST
Scans a GitHub repository tree for every SKILL.md file and returns candidates the UI can render for user selection. Read-only - no directives are created. Required scope: context:read

Headers

string
required
Bearer token. Example: Bearer runtm_xxx
string
Scope to an organization (uses the org’s GitHub App installation for repo access).

Body

string
required
GitHub repository in owner/repo format (3–256 chars).
string
Git ref to scan (branch, tag, or SHA). Defaults to the repo’s default branch.

Response

string
The repository that was scanned.
string | null
The ref that was resolved.
string
The commit SHA at the time of scanning.
array
Array of skill candidates found in the repo. Each includes path, dir, name, display_name, description, size_bytes, frontmatter, and already_imported.
boolean
true if the scan hit the maximum number of candidates.