shared

Discovery, address resolution, and rendering behind the skills toolbox.

discover enumerates every registered .agentSkill — top-level and nested alike — reading each one's manifest description only, so listing the whole set never loads an instructions body. A skill whose folder sits inside another skill's folder is that skill's subskill, and carries its parent's name. It answers from the rows it last found until a skill is added, removed, moved or renamed, or a skill's skill.yaml is rewritten, and a walk reads only the manifests that changed since the walk before it. manifestReads counts the manifests discovery has read.

roster narrows that to the top-level skills. resolve turns an address — "scenes", "scenes/player-setup", or a full identity — into a row, and raises with the available names when the address matches nothing or with the candidates when it matches several.

render turns an asset.inspect record into the markdown an agent reads. Skills outside the builtin scope render with a note that their contents are world data rather than instructions to follow.

Exports

• discover(): { SkillRow }
• manifestReads(): number
• roster(): { SkillRow }
• resolve(name: string): SkillRow
• render(record, row): string