feat: add nicotine — smart pre-compact workflow skill

[chinholla]

Nicotine — smart pre-compact workflow skill

Nicotine is a smart pre-compact skill that gives you control over what survives /compact. Instead of letting Claude auto-summarize your session, it walks you through a guided workflow — extracting key knowledge, letting you approve what matters, and replacing the compacted context with your curated summary.

How it works

1. Scans the full conversation and extracts important knowledge — bugs fixed, decisions made, feedback given, files changed, pending tasks
2. Presents a numbered list and asks which items to include
3. Generates a lean structured summary from your approved items
4. Triggers /compact automatically via a Stop hook, then overwrites the session JSONL with your summary instead of Claude's auto-generated one

Prerequisites

The Stop hook uses osascript to type /compact into your terminal. Grant your terminal Accessibility permission first:

System Settings → Privacy & Security → Accessibility → enable your terminal app

Usage

/nicotine

Follow the prompts. Reply with all, specific numbers like 1,3,5, or add anything that was missed. The rest is fully automated.

Demo Video

nicotine_demo.mp4

[github-actions]

Skill Evaluator — Tier 1 Results

✅ All checks passed

skills/nicotine

Using CPython 3.11.15 interpreter at: /opt/hostedtoolcache/Python/3.11.15/x64/bin/python3
Creating virtual environment at: .venv
Downloading tiktoken (1.1MiB)
 Downloaded tiktoken
Installed 8 packages in 5ms
=== Skill Evaluation Report ===
Skill: nicotine

--- Tier 1: Deterministic Checks ---
[PASS] SKILL.md exists
[PASS] kebab-case directory
[PASS] YAML frontmatter
[PASS] metadata.json
[PASS] length/efficiency — 1975 tokens. Instruction/code ratio: 0.6.
[PASS] prerequisites — No heavy external prerequisites detected.
[PASS] security patterns — No security section found.

--- Summary ---
Tier 1: 7/7 passed