---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/skills/interfaces/DiscoveredSkill.md
description: >-
  Discovery result. Carries the ROUTING METADATA — `name` and `description` —
  because that is what `list_skills` shows the model and what it chooses on;
  requiring `descriptor()` to obtain it would mean loading every skill's module
  just to list the catalog.
---

# Interface: DiscoveredSkill

Defined in: [src/batteries/skills/contracts.ts:8](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L8)

Discovery result. Carries the ROUTING METADATA — `name` and `description` — because that is
what `list_skills` shows the model and what it chooses on; requiring `descriptor()` to obtain
it would mean loading every skill's module just to list the catalog.

## Properties

| Property                                             | Type                                                                                                                                                                                                            | Description                                                                              | Defined in                                                                                                                        |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|  `compatibility?` | `string`                                                                                                                                                                                                        | Free-form compatibility note; surfaced but deliberately not parsed or enforced.          | [src/batteries/skills/contracts.ts:18](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L18) |
|  `description`      | `string`                                                                                                                                                                                                        | Routing text shown to the model without loading the skill body.                          | [src/batteries/skills/contracts.ts:22](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L22) |
|  `id`                        | `string`                                                                                                                                                                                                        | Stable source-assigned identity used for catalog routing and load operations.            | [src/batteries/skills/contracts.ts:10](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L10) |
|  `license?`             | `string`                                                                                                                                                                                                        | agentskills.io passthrough, surfaced pre-load. Optional: a source may not have them.     | [src/batteries/skills/contracts.ts:14](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L14) |
|  `metadata?`           | [`Readonly`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype)<[`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `string`>> | Client-specific agentskills.io properties surfaced before load for provenance and audit. | [src/batteries/skills/contracts.ts:16](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L16) |
|  `name`                    | `string`                                                                                                                                                                                                        | Human-facing name used in routing metadata.                                              | [src/batteries/skills/contracts.ts:20](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L20) |
|  `version`              | `string`                                                                                                                                                                                                        | Source version used to detect an available update without loading the descriptor.        | [src/batteries/skills/contracts.ts:12](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/contracts.ts#L12) |