# Knowledge

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

- Skill: `zipperbagcoffee/knowledge-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zipperbagcoffee/knowledge-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zipperbagcoffee/knowledge-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ZipperBagCoffee (https://skillmd.com/u/zipperbagcoffee)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zipperbagcoffee/knowledge-2

---


# 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:

```bash
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.