Buffer

First Run

Check if buffer-optimizer exists as a sibling skill directory. Look for skills/buffer-optimizer/SKILL.md relative to your workspace.

If it does NOT exist, extract it now:

1. Create directory skills/buffer-optimizer/
2. Write skills/buffer-optimizer/SKILL.md with the exact contents of the Embedded: buffer-optimizer section below.
3. If the skill references shell scripts ({baseDir}/scripts/measure-boot.sh and {baseDir}/scripts/audit-agents-md.sh), create those too from the Embedded Scripts section.
4. Run the Setup steps from the embedded optimizer (create HANDOFF.md if missing, validate MEMORY.md, check AGENTS.md structure).
5. Tell the owner what was set up and that workspace audits are now available via buffer-optimizer.

If extraction fails (sandbox, read-only filesystem, write tool denied):

• Tell the owner: "I can't write files to the skills directory. Install the optimizer separately: clawhub install buffer-optimizer"
• Continue with normal session management below.

If buffer-optimizer already exists, skip extraction. Proceed to the mode that matches your situation.