docs: trim generated prose

packages/skill/skill/src/index.ts

@@ -174,26 +174,14 @@ export class SkillService extends Service {
   }
 
   /**
-   * Register a skill provider synchronously during the provider plugin's
-   * `apply()`. Throws if another provider already owns the same provider name,
-   * including the reserved runtime provider name. Providers that need remote
-   * initialization do that work inside `list()` after registration. The name
-   * and callback identities are snapshotted at registration, so later
-   * replacement of those fields cannot change the registry key, dispatch
-   * callbacks, or HMR cleanup identity. Bound callbacks retain the original
-   * provider object as their receiver, so provider-owned mutable state remains
-   * live. Effect-scoped and HMR-safe: disposing the caller's fiber unregisters
-   * the provider and invalidates cached catalogs.
+   * Register a skill provider synchronously during the provider plugin's `apply()`.
+   *
    * @param 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.
    */
   registerProvider(provider: SkillProvider): () => Promise<void> | void {
-    // Snapshot the registration contract before entering the effect. The
-    // callback binding preserves the historical method receiver while making
-    // replacement of `provider.list`/`provider.get` after registration inert.
-    // In particular, cleanup must never re-read caller-owned `provider.name`:
-    // an HMR host may mutate or reuse that object before its old fiber unloads.
+    // Snapshot the registration contract before entering the effect.
     const snapshot: SkillProvider = Object.freeze({
       name: provider.name,
       list: provider.list.bind(provider),

packages/skill/tool-skill/src/index.ts

@@ -66,10 +66,8 @@ export function apply(ctx: Context, config: Config = {}): void {
     throw new Error('dsh-tool-skill: registered skill tool is not visible in the global registry')
   }
 
-  // Register after the tool so reverse-order fiber teardown removes this
-  // guidance listener before its referenced tool. Exact definition identity is
-  // the shared truth for restrictions and scoped shadows: another tool merely
-  // named `skill` must not inherit this plugin's catalog or instructions.
+  // Register after the tool so reverse-order fiber teardown removes this guidance listener
+  // before its referenced tool.
   ctx.on('agent/session-prefix', async (agent, _prefix, signal, next): Promise<Message[]> => {
     if (ctx.tools.get(skillTool.name, agent) !== registeredSkillTool) return await next()
     const skills = await ctx.skills.list({ cwd: agent.session.header.cwd, signal })