---
title: "GET /experimental/orgs/{orgId}/agent-signals/skills"
method: GET
path: "/experimental/orgs/{orgId}/agent-signals/skills"
tags: ["Orgs", "Agent Signals"]
---

# GET /experimental/orgs/{orgId}/agent-signals/skills

`GET /experimental/orgs/{orgId}/agent-signals/skills`

Lists skills with the highest activation or read count for an organization. Activation and read counts, distinct users, and distinct sessions are reported separately and are never combined.

## Path parameters

- `orgId` string, uuid, required

## Query parameters

- `rankBy` union
  - 'skill.activation'
  - 'skill.read'
- `page[size]` number
- `page[number]` integer

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, required
    - `type` 'agent-signal-skill-aggregate', required
    - `attributes` object, required
      - `name` string, required
      - `namespace` string, nullable, required
      - `activation` object, required
        - `count` number, required
        - `distinctUsers` number, required
        - `distinctSessions` number, required
      - `read` object, required
        - `count` number, required
        - `distinctUsers` number, required
        - `distinctSessions` number, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-23** `6da83f4191fc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/agent-signals/skills/get.md)

---

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