# ckb-module — edge cases Reference material for the `ckb-module` skill. Read when a run hits an unusual situation the main steps don't cover. - **A module directory with no `module.yaml`** — not a module. Report it as malformed; don't try to infer its contents from its file layout. - **The user asks for a capability no module provides** — say so, and don't install a near-match hoping it fits. Offer to note it in `wiki/query-gaps.md`. - **`ckb-upgrade` brought a newer version of an installed module** — the installed skill copies are stale. Offer to reinstall; show what changed before doing it. - **Markers missing at uninstall** (someone hand-edited `AGENTS.md`) — don't guess at the block's boundaries. Show the fragment and ask the user to remove it, or point at exactly what to delete. - **A module's skill was renamed upstream** — treat as collision (Step 2), ask. Don't delete the old name automatically. --- *Licensed under the Apache License, Version 2.0 — see [LICENSE](../../../LICENSE) at the repository root, or .*