---
title: "Inspect the verified skill a root name addresses"
method: GET
path: "/v1/skills/{root}"
tags: ["public"]
---

# Inspect the verified skill a root name addresses

`GET /v1/skills/{root}`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/skills/{root}`
- Auth: none declared

A root name is one segment the registry assigns to a verified publisher's skill. The answer is that skill read by its canonical `publisher/name`; a root name can move, a canonical id cannot.

## Path parameters

- `root` string, required

## Response `200`

Public skill detail.

- PublicSkillDetailResponse
  - `status` 'success', required
  - `skill` PublicSkillDetail, required
    - `skill_id` string, required
    - `owner` string, required
    - `publisher` PublicPublisher, required
      - `id` string, required
      - `slug` string, required
      - `handle` string, required
      - `display_name` string, required
      - `kind` 'org' | 'user' | 'team', required
      - `verified` boolean, required
      - `image` PublicMark
        - `sha256` string, required
        - `url` string, required
      - `url` string, required
    - `trust_tier` 'first_party' | 'verified' | 'community', required
    - `maturity` 'alpha' | 'beta' | 'stable', required
    - `name` string, required
    - `title` string, required
    - `summary` string
    - `mark` union, required
      - PublicDeclaredMark
        - `sha256` string, required
        - `url` string, required
        - `source` 'own' | 'category', required
      - PublicBoundConnectorMark
        - `sha256` string, required
        - `url` string, required
        - `source` 'connector', required
        - `connector_ref` string, required
    - `discoverable` boolean, required
    - `relationships` PublicSkillRelationship[]
      - `kind` 'evidence_source' | 'handoff' | 'ecosystem', required
      - `id` string, required
      - `label` string, required
      - `reference` string
    - `connectors` PublicSkillConnector[], required
      - `ref` string, required
      - `version` string, required
      - `name` string, required
      - `runtime_capability` boolean, required
      - `trust_tier` 'first_party' | 'verified' | 'community'
      - `mark` PublicDeclaredMark, required
        - `sha256` string, required
        - `url` string, required
        - `source` 'own' | 'category', required
    - `description` string
    - `catalog_kind` 'skill' | 'graph', required
    - `version` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `profile_mode` 'profiled' | 'portable', required
    - `runner_names` string[], required
    - `paid_listing` PaidSkillListingContract
      - `skill_id` string, required
      - `version` string, required
      - `skill_digest` string, required
      - `profile_digest` string, required
      - `package_digest` string, required
      - `vendor_ref` object, required
        - `schema` string
        - `uri` string, required
        - `provider` string
        - `locator` string
        - `label` string
        - `observed_at` string
        - `proof_kind` string
        - `type` 'principal', required
      - `offers` object, required
    - `required_scopes` string[], required
    - `tags` string[], required
    - `category` string, required
    - `category_label` string, required
    - `install_count` number, required
    - `verified_run_count` number, required
    - `last_verified_run_at` string
    - `page_url` string, required
    - `install_command` CopyableCommand, required
      - `shell` 'posix', required
      - `argv` string[], required
      - `copy_text` string, required
    - `run_command` CopyableCommand, required
      - `shell` 'posix', required
      - `argv` string[], required
      - `copy_text` string, required
    - `catalog_visibility` 'public' | 'internal'
    - `attestations` PublicRegistryAttestation[], required
      - `kind` 'source' | 'publisher' | 'verification', required
      - `id` string, required
      - `status` 'verified' | 'declared', required
      - `summary` string, required
      - `source` string
      - `issued_at` string
      - `metadata` object
    - `digest` string, required
    - `profile_digest` string
    - `content_digest` string, required
    - `presentation` PublicSkillPresentation
      - `title` string
      - `overview` string
      - `method` object[]
        - `title` string, required
        - `description` string, required
        - `skill_ref` string
        - `runner` string
        - `skill` object
          - `skill_id` string, required
          - `name` string, required
          - `page_url` string, required
      - `inputs` object[]
        - `label` string, required
        - `description` string
        - `input` string
      - `outputs` object[]
        - `label` string, required
        - `description` string
      - `stops` object
        - `title` string, required
        - `description` string
      - `example` object
        - `title` string, required
        - `path` string, required
        - `url` string, required
      - `relationships` PublicSkillRelationship[]
        - `kind` 'evidence_source' | 'handoff' | 'ecosystem', required
        - `id` string, required
        - `label` string, required
        - `reference` string
    - `files` PublicSkillFiles, required
      - `manual` string, required
      - `profile` string
      - `catalog` string
    - `versions_url` string, required
    - `markdown` string, required
    - `profile_document` string
    - `harness` PublicHarnessSummary, required
      - `status` 'passed' | 'failed' | 'not_recorded' | 'older_version' | 'unavailable', required
      - `declared_case_count` number, required
      - `declared_cases` object[], required
        - `name` string, required
        - `runner` string
        - `expected_status` string
      - `case_count` number, required
      - `checks_passed` number
      - `checks_failed` number
      - `receipt_ids` string[], required
      - `evidence_url` string
      - `latest_run` PublicEvidenceEvent
        - `id` string, required
        - `kind` string, required
        - `source` string, required
        - `status` 'success' | 'failure' | 'pending' | 'running' | 'waiting' | 'cancelled', required
        - `title` string, required
        - `timestamp` string, required
        - `summary` string
        - `repo` string
        - `workflow` string
        - `branch` string
        - `commit` string
        - `skill_id` string
        - `run_id` string
        - `receipt_id` string
        - `url` string
        - `metadata` object
        - `harness` PublicHarnessResult
          - `producer` string, required
          - `verification` 'registry' | 'publisher', required
          - `suite` string, required
          - `attempt_id` string, required
          - `version` string, required
          - `content_digest` string, required
          - `result` 'passed' | 'failed', required
          - `checks_total` number, required
          - `checks_passed` number, required
          - `checks_failed` number, required
          - `runtime` string
      - `results` PublicEvidenceEvent[], required
        - `id` string, required
        - `kind` string, required
        - `source` string, required
        - `status` 'success' | 'failure' | 'pending' | 'running' | 'waiting' | 'cancelled', required
        - `title` string, required
        - `timestamp` string, required
        - `summary` string
        - `repo` string
        - `workflow` string
        - `branch` string
        - `commit` string
        - `skill_id` string
        - `run_id` string
        - `receipt_id` string
        - `url` string
        - `metadata` object
        - `harness` PublicHarnessResult
          - `producer` string, required
          - `verification` 'registry' | 'publisher', required
          - `suite` string, required
          - `attempt_id` string, required
          - `version` string, required
          - `content_digest` string, required
          - `result` 'passed' | 'failed', required
          - `checks_total` number, required
          - `checks_passed` number, required
          - `checks_failed` number, required
          - `runtime` string
      - `recent_runs` PublicEvidenceEvent[], required
        - `id` string, required
        - `kind` string, required
        - `source` string, required
        - `status` 'success' | 'failure' | 'pending' | 'running' | 'waiting' | 'cancelled', required
        - `title` string, required
        - `timestamp` string, required
        - `summary` string
        - `repo` string
        - `workflow` string
        - `branch` string
        - `commit` string
        - `skill_id` string
        - `run_id` string
        - `receipt_id` string
        - `url` string
        - `metadata` object
        - `harness` PublicHarnessResult
          - `producer` string, required
          - `verification` 'registry' | 'publisher', required
          - `suite` string, required
          - `attempt_id` string, required
          - `version` string, required
          - `content_digest` string, required
          - `result` 'passed' | 'failed', required
          - `checks_total` number, required
          - `checks_passed` number, required
          - `checks_failed` number, required
          - `runtime` string
      - `older_version` PublicEvidenceEvent
        - `id` string, required
        - `kind` string, required
        - `source` string, required
        - `status` 'success' | 'failure' | 'pending' | 'running' | 'waiting' | 'cancelled', required
        - `title` string, required
        - `timestamp` string, required
        - `summary` string
        - `repo` string
        - `workflow` string
        - `branch` string
        - `commit` string
        - `skill_id` string
        - `run_id` string
        - `receipt_id` string
        - `url` string
        - `metadata` object
        - `harness` PublicHarnessResult
          - `producer` string, required
          - `verification` 'registry' | 'publisher', required
          - `suite` string, required
          - `attempt_id` string, required
          - `version` string, required
          - `content_digest` string, required
          - `result` 'passed' | 'failed', required
          - `checks_total` number, required
          - `checks_passed` number, required
          - `checks_failed` number, required
          - `runtime` string
    - `recent_activity` PublicFeedItem[], required
      - `id` string, required
      - `source` 'runx-hosted' | 'public-evidence', required
      - `status` string, required
      - `title` string, required
      - `target` string, required
      - `timestamp` string, required
      - `summary` string
      - `repo` string
      - `workflow` string
      - `branch` string
      - `commit` string
      - `run_id` string
      - `receipt_id` string
      - `skill_id` string
      - `actions_count` number
      - `url` string
      - `principal` string
      - `principal_handle` string
      - `signer_trust` 'verified' | 'community' | 'unverified'
      - `scopes` string[]
      - `parent_receipt_id` string
      - `graph_depth` number
      - `metadata` object
    - `source` PublicRegistrySource
      - `provider` 'github', required
      - `repo` string, required
      - `repo_url` string, required
      - `skill_path` string, required
      - `profile_path` string
      - `ref` string, required
      - `sha` string, required
      - `default_branch` string, required
      - `event` 'enrollment' | 'push' | 'tag' | 'tombstone', required
      - `immutable` boolean, required
      - `live` boolean, required
      - `tombstoned` boolean
      - `tag` string
      - `publisher_handle` string

## Other responses

- `404`: No listed skill holds that root name.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)