# Get pinned skill (/api/skills/get-skill-pin)

`GET /api/skill/{name}`

Returns the pinned commit, GitHub archive URL, and SHA-256 checksum for a StarSling-managed agent skill. The caller must belong to the requested GitHub organization.

Base URL: `https://runners.starsling.dev`

## Authentication

Requires a bearer token (`Authorization: Bearer`).

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| `name` | path | string | yes | Name of a pinned skill. e.g. `ci-speedup` |
| `org` | query | string | yes | GitHub organization login. The caller must be a member. e.g. `acme` |

## Responses

| Status | Description |
| --- | --- |
| `200` | A pinned skill: one commit, its codeload archive URL, and the archive's SHA-256. |
| `401` | `UNAUTHENTICATED`: no credential, or an expired one — run `sling login`. `GITHUB_REAUTH_REQUIRED`: signed in, but the stored GitHub sign-in cannot read org membership — sign out of StarSling in the browser and sign in with GitHub again; `message` says why. |
| `403` | Not a member of the requested organization. |
| `404` | No pinned skill with this name. |
| `422` | A path or query parameter failed schema validation. `details` names each offending field. |
| `500` | The request was valid; the control plane or a dependency it calls failed. |

### `200` body

- `commit` — string, required
- `sha256` — string, required
- `tarball_url` — string, required

### Example

```json
{
  "commit": "8c724c95eca0b6bf4ccefc411197c23593892110",
  "tarball_url": "https://codeload.github.com/starslingdev/skills/tar.gz/8c724c95eca0b6bf4ccefc411197c23593892110",
  "sha256": "8405ac78e99303df3cc6af2de13fba4139b82e969a0fdf495b63a0c411376ec6"
}
```