---
title: "Import Skill"
method: POST
path: "/api/skills/import"
tags: ["skills"]
---

# Import Skill

`POST /api/skills/import`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/skills/import`
- Auth: none declared

## Query parameters

- `skill_md` string, nullable

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `201`

Successful Response

- SkillOut
  - `id` string, uuid, required
  - `slug` string, required
  - `library_id` string, uuid, nullable
  - `library_name` string, nullable
  - `frontmatter` SkillFrontmatterOut, required
    - `license` string, nullable
    - `compatibility` string, nullable
    - `metadata` object
    - `extra_frontmatter` object
    - `name` string, nullable
    - `description` string, required
    - `when_to_use` string, nullable
    - `when_not_to_use` string, nullable
    - `argument_hint` string, nullable
    - `arguments` string[]
    - `disable_model_invocation` boolean
    - `user_invocable` boolean
    - `allowed_tools` string[]
    - `model` string, nullable
    - `effort` 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
    - `context` 'inline' | 'fork'
    - `agent` string, nullable
    - `paths` string[]
    - `shell` 'bash' | 'powershell'
    - `hooks` object, nullable
    - `extensions` SkillExtensionsOut
      - `session_latch` boolean
      - `builtin_holders` string[]
      - `menu_summary` string, nullable
      - `interaction_source` string, nullable
      - `capabilities` string[]
      - `side_effects` string[]
      - `token_budget` integer, nullable
    - `capability_review` SkillCapabilityReviewOut[]
      - `source` string, required
      - `key` string, required
      - `status` 'supported' | 'operator_gated' | 'metadata_only' | 'blocked', required
      - `message` string, required
      - `requested` string[]
      - `tool_patterns` string[]
  - `bundle_hash` string, nullable
  - `schema_version` string, required
  - `version` integer, required
  - `enabled` boolean, required
  - `approved` boolean, required
  - `requires_admin_approval` boolean
  - `visibility` 'private' | 'public', required
  - `source_kind` 'authored' | 'imported' | 'bundled' | 'plugin', required
  - `imported_from` string, nullable
  - `import_status` 'installing' | 'failed' | 'ready'
  - `import_error` string, nullable
  - `body` string, required
  - `tool_reachability_warnings` string[]
  - `bundled_programs` string[]
  - `import_warnings` string[]

## Other responses

- `422`: Validation Error

---

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