Skills · skillsGet

Read a skill

Workspace scope. Requires skill read permission. URL-encode nested Markdown paths; absent files return empty content, matching the shared skill library.

GET/v1/skills/{path}

betaapiKeyworkspace

When to use

Read a business instruction file.

For agents

The SDK URL-encodes nested paths. Missing files return empty content.

Example

typescript

import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.skills.get('finance/revenue.md');

Response

json

{
  "data": {
    "content": "# Revenue reporting\n\nUse the Net revenue fact for revenue analysis."
  }
}