Fetch a skill's full instruction set from its source marketplace and return it without creating any record. Use this to inspect the skill content before deciding whether to import it.

## Query parameters

**`marketplace`** string required

Driver ID the skill originates from (for example, `skillsmp`).

**`external_id`** string required

Marketplace-native identifier for the skill to preview.

## Returns

Returns a `MarketplaceSkillPreviewResponse` with `marketplace`, `external_id`, `name`, `display_name`, `description`, `content` (the full instruction set in markdown), `applicability`, and optional `allowed_tools`, `argument_hint`, `aliases`, `source_url`, and `source_version`.

Request

```bash cURL
curl "https://api.aitronos.com/v1/skills/marketplace/preview?marketplace=skillsmp&external_id=ext_123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


```python Python SDK
# A first-class SDK method for this endpoint is coming soon.
# In the meantime, call the endpoint directly with the SDK's HTTP client:
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")
response = client._client_wrapper.httpx_client.request(
    "skills/marketplace/preview",
    method="GET",
    params={"marketplace": "skillsmp", "external_id": "ext_123"},
)
print(response.json())
```


```python Python
import requests, os

response = requests.get(
    "https://api.aitronos.com/v1/skills/marketplace/preview",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
    params={"marketplace": "skillsmp", "external_id": "ext_123"},
)
print(response.json())
```


```javascript JavaScript
const params = new URLSearchParams({ marketplace: 'skillsmp', external_id: 'ext_123' });
const response = await fetch(`https://api.aitronos.com/v1/skills/marketplace/preview?${params}`, {
  headers: { 'Authorization': `Bearer ${process.env.ACCESS_TOKEN}` },
});
console.log(await response.json());
```

Response

```json 200 OK
{
  "marketplace": "skillsmp",
  "external_id": "ext_123",
  "name": "code-review",
  "display_name": "Code Review",
  "description": "Reviews pull requests for issues.",
  "content": "# Code Review\n\nReview the diff for...",
  "applicability": "code_repository",
  "allowed_tools": null,
  "argument_hint": null,
  "aliases": null,
  "source_url": "https://example.com/skills/code-review",
  "source_version": "1.2.0"
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "SKILL_MARKETPLACE_SKILL_NOT_FOUND",
    "message": "The requested marketplace skill could not be found.",
    "system_message": "Marketplace or skill not found",
    "type": "client_error",
    "status": 404,
    "details": { "marketplace": "skillsmp", "external_id": "ext_123" },
    "trace_id": "req_abc123xyz",
    "timestamp": "2026-04-15T10:00:00Z"
  }
}
```


```json 503 Service Unavailable
{
  "success": false,
  "error": {
    "code": "SKILL_MARKETPLACE_UNAVAILABLE",
    "message": "The skill marketplace is temporarily unavailable.",
    "system_message": "Marketplace unavailable",
    "type": "server_error",
    "status": 503,
    "details": { "marketplace": "skillsmp" },
    "trace_id": "req_abc123xyz",
    "timestamp": "2026-04-15T10:00:00Z"
  }
}
```

## Related Resources

- [Search marketplaces](/docs/api-reference/skills/search-marketplaces)
- [Import marketplace skill](/docs/api-reference/skills/import-marketplace-skill)
- [List skill marketplaces](/docs/api-reference/skills/list-marketplace-connections)