Knowledge

Create a Crabshell K knowledge page from Codex. Use for verified facts and operational tips discovered through project work.

ZipperBagCoffee Updated

File contents

Knowledge

Resolve {SKILL_DIR} to the directory containing this SKILL.md and {PROJECT_ROOT} to the absolute active project root. Run the bundled script by its absolute path with that project as the explicit target:

node "{SKILL_DIR}/scripts/codex-docs.js" knowledge "title" --category="fact|tip" --what="..." --when="..." --source="..." --tags="tag1,tag2" --project-dir="{PROJECT_ROOT}"

The script creates .crabshell/knowledge/K{NNN}-*.md and appends to .crabshell/knowledge/INDEX.md.

K-pages are append-only: do not edit existing K-pages — create a new one if a fact has changed. Defaults: category=fact, source=observation, what/when=TBD. if omitted.

Before creating a K-page, check that the "What" content is a fact about how something behaves (belongs in knowledge/) rather than a behavioral rule for the assistant (belongs in CLAUDE.md). If it overlaps with rule keywords (scope, verification, understanding, sycophancy, pressure, guard, hook, bailout, prohibited), confirm with the user before proceeding.

ZipperBagCoffee/memory-keeper-plugin/tree/main/codex-skills/knowledge commit c0a8a707f9

Frequently asked questions

npx skillmds@latest add zipperbagcoffee/knowledge-2