Merge pull request #186 from NVIDIA-NeMo/fix/hide-skill-lifecycle-docs

Hide skill lifecycle hooks from agent docs

Author: sklinglernv

src/nooa/skill.py

@@ -302,13 +302,15 @@ def __init__(self, obj: Any = None, *, content: str | None = None, name: str | N
             cls_name = name or "Skill"
             self.__class__ = type(cls_name, (Skill,), {"__doc__": content})  # pyright: ignore[reportAttributeAccessIssue]
 
+    @hidden
     def attach(self, agent: Any) -> None:
         """Called when this skill is installed on an agent.
 
         Subclasses can override to perform setup that requires the agent reference.
         """
         self._agent = agent
 
+    @hidden
     def detach(self) -> None:
         """Called when this skill is removed from an agent."""
         self._agent = None

tests/agentdoc/test_skill_lifecycle_visibility.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+"""Skill lifecycle hooks are framework plumbing, not model-facing tools."""
+
+from nooa.agentdoc import doc
+from nooa.skill import Skill
+
+
+class ExampleSkill(Skill):
+    """A useful example skill."""
+
+    def useful(self, value: str) -> str:
+        """Return a useful value."""
+        return value
+
+
+def test_skill_lifecycle_hooks_are_hidden_from_docs():
+    rendered = doc(ExampleSkill)
+
+    assert "def useful(" in rendered
+    assert "def attach(" not in rendered
+    assert "def detach(" not in rendered