Skip to main content
skill CX Codex

heretic — Claude Code skill: what it does, how to install

The heretic skill runs directional ablation and refusal analysis on open-weight models. Use it to study refusals or reduce benign over-refusal without fine-tuning.

AGPL-3.0-or-later 143 installs ★ 61 updated 2026-11-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add akillness/jeo-skills --skill heretic -a claude-code
Open on GitHub

What heretic does

heretic estimates refusal directions from model activations, then alters attention and MLP projection matrices with directional ablation. An Optuna optimizer searches for settings that reduce refusals while keeping the candidate close to the original under KL divergence. It does not perform training or post-training.

The skill supports model ablation, candidate evaluation, and residual-geometry research. Residual plots need the heretic-llm[research] extra, while model and dataset discovery is routed through the scrapling skill. Use it only with open-weight models you have the right to modify.

The runtime requires Python 3.10+ and PyTorch 2.2+; MXFP4 models such as gpt-oss require PyTorch 2.6+. A CUDA GPU is strongly recommended, and bitsandbytes can provide 4-bit quantization for larger models.

What it helps with

  • reduce benign refusals in an open-weight model
  • measure refusals and KL divergence
  • inspect refusal-direction geometry
  • generate residual-geometry plots
  • fit ablation to available VRAM

Example prompts for the agent

  • Reduce benign refusals in Qwen/Qwen3-4B-Instruct-2507 without running training.
  • Evaluate p-e-w/gemma-3-12b-it-heretic against its original model using refusal and KL metrics.
  • Print residual geometry and create the per-layer plots.

How to install heretic

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill heretic -a claude-code

2Manually: put the files in place

~/.claude/skills/heretic/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/heretic/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about heretic

How do I install heretic in Claude Code?

Run npx skills add akillness/jeo-skills --skill heretic -a claude-code, then check ~/.claude/skills/heretic/SKILL.md.

What does heretic do?

It applies directional ablation to an open-weight model to reduce refusals, then compares the result with the original using refusal and KL-divergence metrics. It can also inspect and plot residual geometry.

What does heretic require to run?

You need Python 3.10+ and PyTorch 2.2+. MXFP4 models such as gpt-oss need PyTorch 2.6+, and a CUDA GPU is strongly recommended.

Similar skills

All skills for AI and ML →

From the same set99

The whole set →
deep-dive deep-dive — a two-stage skill: three parallel lanes trace why something broke, then a requirements interview starts from those findings. Built for bugs and changes in code you don't know yet. CX Codex +1 177installs spec-kit Installs GitHub's specify CLI, bootstraps a spec-driven project for your agent, and runs the /speckit.* pipeline from constitution to implementation. CX Codex +1 167installs academic-research academic-research sorts a research topic or paper draft into one of several linked academic workflows, from literature discovery to peer review. The skill itself decides which branch and mode fit the request. CX Codex +1 148installs opik Configure Opik to trace LLM calls, evaluate responses, and monitor runs. Use the skill when you need to assess prompts or compare experiments. CX Codex +1 146installs astryx astryx is a Claude Code skill for building React design systems and component libraries. It activates for work on themes, design tokens, and accessible UI components. CX Codex +1 141installs slides-grab slides-grab turns a topic into a deck of HTML/CSS slides, lets you box a region in the browser and have the agent redo just that part, then exports to PDF or PNG. CX Codex +1 141installs typesense Sets up Typesense search backend, collection schemas, and typo tolerance. Useful for building product search or migrating from Algolia. CX Codex +1 139installs codeflow codeflow is a Claude Code skill that turns a repository, PR, local folder, or Markdown vault into an interactive architecture map. Use it to inspect dependencies, change impact, and codebase health. CX Codex +1 132installs

Project sponsors

Companies that keep this analytics open