List shared skills – GET /v1/skills | Permute Developer Docs

GET/v1/skills

betaapiKeyworkspace

When to use

Discover shared Markdown context before analysis.

For agents

Read the relevant files next; private skills are excluded.

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.list();

Response

json

{
  "data": {
    "items": [
      {
        "file": "finance/revenue.md",
        "description": "Revenue reporting guidance",
        "lastModified": "2026-09-10T12:00:00.000Z"
      }
    ]
  }
}