# ctx.skills `SkillService` — provided by `@deepseek-ai/dsh-skill`. Registry of skill providers. It merges provider catalogs with stable first-wins duplicate handling, exposes sorted model-visible summaries, and loads full skill bodies on demand. [Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/skill/skill/src/index.ts#L141) ### ctx.skills.registerProvider(provider) ```ts website-api registerProvider(provider: SkillProvider): () => void ``` Register a borrowed same-process provider synchronously during plugin apply. Duplicate and reserved names throw; remote initialization belongs in `list()`. Fiber disposal unregisters the provider and invalidates catalog caches. - `provider` — the provider to register by `provider.name`. **Returns** the exact Cordis effect disposer that unregisters this provider; composite effects may yield it directly to preserve teardown ordering. [Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/skill/skill/src/index.ts#L168) ### ctx.skills.register(skill) ```ts website-api register(skill: SkillRegistration): () => void ``` Register a borrowed readonly runtime skill. Project entries outrank runtime entries, which outrank user entries. Same-name runtime entries are first-wins; a duplicate logs a warning and receives a no-op disposer so it cannot remove the winner. - `skill` — the complete skill definition to expose for discovery. **Returns** the exact Cordis effect disposer, preserving composite teardown order and invalidating caches. [Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/skill/skill/src/index.ts#L199) ### ctx.skills.list(options?) ```ts website-api async list(options: SkillLookupOptions = {}): Promise ``` List model-invocable skill summaries for a workspace. Lookup options and provider candidates are readonly same-process values borrowed throughout discovery. - `options` — lookup options; `cwd` selects project roots and `signal` cancels discovery. **Returns** sorted summaries, excluding skills disabled for model invocation. [Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/skill/skill/src/index.ts#L230) ### ctx.skills.get(name, options?) ```ts website-api async get(name: string, options: SkillLookupOptions = {}): Promise ``` Load and validate the winning candidate, passing its opaque discovery locator back to the provider. Cancellation is rechecked after selection, including cache hits, and raced against loading so an uncooperative provider cannot hang the caller. - `name` — kebab-case skill name. - `options` — lookup options; `cwd` selects workspace-sensitive skills and `signal` cancels work. **Returns** the full skill, including body content, or `undefined`. [Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/skill/skill/src/index.ts#L246)