---
title: "Fetch raw SKILL.md for activation (lightweight endpoint)"
method: GET
path: "/api/v1/skill-content"
tags: ["Content"]
---

# Fetch raw SKILL.md for activation (lightweight endpoint)

`GET /api/v1/skill-content`

## Request

- Base URL: `https://skillrepo.dev`
- URL: `https://skillrepo.dev/api/v1/skill-content`
- Auth: none declared

Returns the raw SKILL.md content for a skill without the MCP protocol overhead. Used by the UserPromptSubmit hook during skill activation.

**Auth**: requires `Authorization: Bearer sk_live_...` but does NOT surface auth failures as 401. Missing/invalid/expired tokens, missing query params, skill-not-found, and skill-with-no-content ALL return the same 404 with `{"error": "not_found"}`. This is intentional — the route never leaks which failure mode applies, so the OpenAPI spec deliberately omits a `security` declaration. Callers MUST still provide a valid bearer token; anything else yields 404.

Unlike the other CLI routes this endpoint does NOT go through `withAccessKey` — it resolves the bearer token directly to preserve the failure-collapse semantics. Scopes are not enforced. Rate limits are not applied at the route level.

## Query parameters

- `owner` string, required: Skill owner (accounts.slug or attributionSlug).
- `name` string, required: Skill name within the owner namespace.

## Response `200`

SKILL.md content + tool name.

- SkillContentResponse: Lightweight activation payload — raw SKILL.md text plus the canonical MCP tool name for the skill.
  - `content` string, required: Raw SKILL.md text content.
  - `name` string, required
  - `owner` string, required: Echoed back from the query param, not normalized.
  - `toolName` string, required: Canonical tool name in the form `skill__{owner}__{name}`, matching the MCP tool-name format exposed to agents.

## Other responses

- `404`: Failure collapse: missing/invalid token, missing params, skill not found, or skill has no SKILL.md content. Body is always `{error: "not_found"}`.

---

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