Claude-code-skills ln-015-hex-line-uninstaller

Use when removing Claude-side hex-line integration surfaces such as MCP registration, permissions, hooks, and output style.

install

source · Clone the upstream repo

git clone https://github.com/levnikolaevich/claude-code-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/levnikolaevich/claude-code-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills-catalog/ln-015-hex-line-uninstaller" ~/.claude/skills/levnikolaevich-claude-code-skills-ln-015-hex-line-uninstaller && rm -rf "$T"

manifest: skills-catalog/ln-015-hex-line-uninstaller/SKILL.md

source content

Paths: File paths are relative to skills repo root. Locate this SKILL.md directory and go up one level for repo root.

Hex-Line Uninstaller

Type: L3 Worker Category: 0XX Shared

Removes Claude-side hex-line integration surfaces. This worker is standalone-capable but also supports managed

ln-010

family transport.

MANDATORY READ: Load

shared/references/coordinator_summary_contract.md

shared/references/environment_worker_runtime_contract.md

, and

shared/references/worker_runtime_contract.md

Input / Output

Direction Content

Input

optional

dry_run

, optional

runId

, optional

summaryArtifactPath

Output

Structured summary envelope with

summary_kind = env-cleanup

payload.status

completed

skipped

error

, plus cleanup outcomes in

changes

detail

Transport inputs:

standalone: omit
```
runId
```
and
```
summaryArtifactPath
```
managed: pass both
```
runId
```
and
```
summaryArtifactPath
```

Runtime

Runtime family:

environment-worker-runtime

Phase profile:

```
PHASE_0_CONFIG
```
```
PHASE_1_RESOLVE_CLAUDE_STATE
```
```
PHASE_2_REMOVE_HEXLINE_REGISTRATION
```
```
PHASE_3_REMOVE_HEXLINE_ARTIFACTS
```
```
PHASE_4_VERIFY_CLEANUP
```
```
PHASE_5_WRITE_SUMMARY
```
```
PHASE_6_SELF_CHECK
```

Runtime rules:

emit
```
summary_kind=env-cleanup
```
standalone runs generate their own
```
run_id
```
and write the default worker-family artifact path
managed runs require both
```
runId
```
and
```
summaryArtifactPath
```
and must write the summary to the exact provided path
always write the validated summary artifact before terminal outcome

Output Contract

Always build a structured

env-cleanup

summary envelope per:

shared/references/coordinator_summary_contract.md

shared/references/environment_worker_runtime_contract.md

Payload fields:

```
mcp_removed
```
```
permissions_cleaned
```
```
hooks_removed
```
```
output_style_removed
```
```
verification
```
```
status
```

What It Removes

Surface	Location	Action
MCP registration	`claude mcp list` / user scope	Remove `hex-line` registration via `claude mcp remove -s user hex-line` when present
Permission entries	`~/.claude/settings.json` and `~/.claude/settings.local.json`	Remove `permissions.allow` entries that target `mcp__hex-line__*`
Hook entries	`~/.claude/settings.json` and `~/.claude/settings.local.json`	Remove hook entries matching the current hex-line hook signature
Output style file	`~/.claude/output-styles/hex-line.md`	Delete file
Output style setting	`~/.claude/settings.json` and `~/.claude/settings.local.json`	Clear only if value is `"hex-line"`
Hook directory	`~/.claude/hex-line/`	Delete only if empty after artifact cleanup

Workflow

Phase 1: Resolve Claude State

Read
```
~/.claude/settings.json
```
if present
Read
```
~/.claude/settings.local.json
```
if present
Detect:
- ```
hex-line
```
  MCP registration in user scope
- ```
permissions.allow
```
  entries for
```
mcp__hex-line__*
```
- hook entries whose command points to the installed hex-line hook
- ```
outputStyle = "hex-line"
```
- installed style file and hook directory
Record exactly which owned surfaces exist before mutating anything

Phase 2: Remove Hex-Line Registration

If user-scope
```
hex-line
```
registration exists, run:

claude mcp remove -s user hex-line

If registration is already absent, report
```
already removed
```
Do not uninstall the npm package here. This worker owns Claude-side integration surfaces only

Phase 3: Remove Hex-Line Artifacts

Update Claude settings surfaces:
- remove
```
permissions.allow
```
  entries for
```
mcp__hex-line__*
```
- remove hook entries whose command contains the active hex-line hook path
- remove empty hook event arrays and remove
```
hooks
```
  only when empty
- clear
```
outputStyle
```
  only when it is exactly
```
"hex-line"
```
Delete
```
~/.claude/output-styles/hex-line.md
```
if present
Delete
```
~/.claude/hex-line/hook.mjs
```
if present
Delete
```
~/.claude/hex-line/
```
only when it is empty after file removal

Rules:

preserve all non-hex-line settings
never claim cache cleanup unless a concrete cache deletion step exists
do not touch unrelated MCP registrations or permission entries

Phase 4: Verify Cleanup

Confirm:

no user-scope
```
hex-line
```
MCP registration remains
no
```
permissions.allow
```
entry targets
```
mcp__hex-line__*
```
no hex-line hook entry remains in managed Claude settings files
```
outputStyle
```
is not
```
"hex-line"
```
```
~/.claude/output-styles/hex-line.md
```
does not exist
```
~/.claude/hex-line/hook.mjs
```
does not exist

Notes

This worker removes Claude-side hex-line integration only
It does not remove the npm package itself
It is safe to run multiple times

Definition of Done

Claude user-scope
```
hex-line
```
MCP registration removed or confirmed absent
```
permissions.allow
```
no longer contains
```
mcp__hex-line__*
```
No hex-line hook entries remain in managed Claude settings files
```
outputStyle: "hex-line"
```
cleared where owned
Installed style and hook artifacts removed
Structured summary returned
Summary artifact written to the managed or standalone runtime path

Version: 1.0.0 Last Updated: 2026-03-27