unharness — скилл для Claude Code: удаление Citadel
Скилл unharness для Claude Code готовит план удаления Citadel из проекта и сохраняет переносимый архив. Запускается по просьбе удалить Citadel или очистить проект от harness.
MIT ★ 937 обновлён 2026-10-29
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-localЧто делает unharness
unharness проверяет квитанцию установки Citadel и составляет план выхода, который не меняет проект. В плане перечислены файлы для удаления или восстановления, изменённые элементы, которые останутся, путь к архиву и неизвестные статусы удаления внешних регистраций.
После явного подтверждения скилл применяет сохранённый план с точным токеном и запускает проверку. Для этого нужны Node.js и доступные скрипты Citadel. Если установка устаревшая, сначала требуется импортировать её; изменённые файлы и неизвестные регистрации скилл не удаляет и не считает доказанно удалёнными.
Какие задачи решает
- составить план удаления Citadel без изменений проекта
- сохранить переносимый архив перед выходом
- оставить изменённые или неоднозначные файлы нетронутыми
- проверить, подтверждены ли удаления внешних регистраций
Примеры запросов агенту
- Удали Citadel из этого проекта и покажи план перед изменениями.
- Очисти проект от harness, сохрани архив и перечисли элементы, которые останутся.
- Сделай человекочитаемый экспорт Citadel без удаления файлов.
Как установить unharness
1Через маркетплейс плагинов
/plugin marketplace add SethGammon/Citadel/plugin install citadel@citadel-localКоманда ставит плагин citadel целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add SethGammon/Citadel --skill unharness -a claude-code3Вручную: положить файлы
~/.claude/skills/unharness/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/unharness/
1Через Skills CLI (Vercel)
npx skills add SethGammon/Citadel --skill unharness -a codex2Вручную: положить файлы
.agents/skills/unharness/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add SethGammon/Citadel --skill unharness -a cursor2Вручную: положить файлы
.cursor/skills/unharness/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install SethGammon/Citadel skills/unharness2Вручную: положить файлы
.github/skills/unharness/SKILL.md1Через Skills CLI (Vercel)
npx skills add SethGammon/Citadel --skill unharness -a gemini-cli2Командой платформы
gemini skills install https://github.com/SethGammon/Citadel --path skills/unharnessВручную: положить файлы
.devin/skills/unharness/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об unharness
Как установить unharness в Claude Code?
Выполни /plugin marketplace add SethGammon/Citadel и затем /plugin install citadel@citadel-local.
Что делает unharness?
Скилл формирует план удаления Citadel, сохраняет переносимый архив и после явного подтверждения применяет план. Изменённые файлы и удаления с неизвестным статусом остаются отмеченными в отчёте.
Что нужно для работы unharness?
Нужны Node.js, скрипты Citadel и действующая квитанция установки. Для старой установки сначала требуется импорт; применение плана требует явного подтверждения и точного токена.
Исходный текст
SKILL.md · MIT
---
name: unharness
license: MIT
description: >-
Safely leave Citadel using the active adoption receipt. Produces a no-write,
reviewable plan, preserves a portable archive, removes only exact owned
material, and reports modified or externally registered surfaces as retained
or unknown. Legacy installs must be imported before exact leave is claimed.
user-invocable: true
auto-trigger: false
trigger_keywords:
- unharness
- remove citadel
- uninstall citadel
- clean up citadel
- remove harness
- uninstall harness
last-updated: 2026-07-30
---
# /unharness - Receipt-owned exit from Citadel
## Orientation
Use this skill when the user wants Citadel removed from a project. Exit is a
two-step, receipt-owned operation. A plan never mutates the project. Apply
requires the exact saved plan and its confirmation token.
Do not infer ownership from familiar paths. Do not delete `.planning/`,
`.citadel/`, runtime settings, hooks, skills, or registrations merely because
they look Citadel-related.
## Protocol
### 1. Locate Citadel and inspect adoption authority
Read `.citadel/plugin-root.txt` when present. Otherwise use the directory
containing this skill. Check for `.citadel/adoption/active.json`; the adoption
planner also checks the private recovery ledger.
### 2. Create a no-write leave plan
Choose a plan path inside the project, such as
`.planning/adoption/leave.plan.json`, and run:
```bash
node {citadelRoot}/scripts/adopt.js leave plan \
--target {projectRoot} \
--out {planPath} \
--json
```
Show the user:
- exact files that will be removed or restored;
- modified or ambiguous footprint entries that will be retained;
- portable archive path;
- runtime registrations whose removal evidence is `unknown`;
- the plan digest and confirmation token.
If the result is `NOT_ADOPTED`, stop. Create a conservative legacy inventory:
```bash
node {citadelRoot}/scripts/adopt.js import plan {citadelRoot} \
--target {projectRoot} \
--out {importPlanPath} \
--json
```
Apply that import only after its own explicit approval. Then create a new leave
plan from the resulting receipt. Never describe legacy cleanup as exact
removal.
### 3. Obtain explicit approval
Leaving is destructive. Ask the user to approve the displayed plan and exact
confirmation token. Do not apply from an unsaved or regenerated plan.
### 4. Apply and verify
After approval:
```bash
node {citadelRoot}/scripts/adopt.js leave apply {planPath} \
--confirm {confirmationToken} \
--json
node {citadelRoot}/scripts/adopt.js doctor \
--target {projectRoot} \
--json
```
Doctor may report `not_adopted` after a clean leave. Report the leave receipt,
archive path, removed entries, retained conflicts, and every `unknown`
unregistration observation. “Citadel removed” is permitted only when the
receipt proves every required local and external removal.
## Export-only compatibility
When the user explicitly wants a human-readable export without leaving:
```bash
node {citadelRoot}/scripts/unharness.js {projectRoot} --export-only
```
This writes the legacy Markdown archive but does not remove harness material.
## Fringe Cases
- If `.planning/` does not exist, treat it as an empty portable-state set and
show the setup/import hint; do not create it merely to leave.
- Missing or invalid adoption authority blocks leave. Use `import plan` or
private-ledger recovery; never guess ownership.
- A changed saved plan, source, target, or pre-image requires a fresh plan.
- An unavailable runtime unregister API stays `unknown`; report the manual
observation required.
- If the Citadel root cannot be located, stop with the exact missing path.
## Quality gates
- Planning is read-only unless the user explicitly requests `--out`.
- Apply consumes the exact saved plan and revalidates source, target, and
pre-images.
- Modified owned material is retained with an explicit conflict.
- Shared runtime files restore exact pre-images only while installed bytes
remain exact.
- Missing receipts, malformed receipts, and unenumerable registrations are
`unknown` or blocked, never successful.
- The portable archive and private receipt ledger remain available for restore
and recovery.
## Exit Protocol
Return the leave operation ID and receipt digest, portable archive path, exact
removed/restored counts, retained conflicts, and unknown external removals.
State plainly whether exact exit was proved. Do not claim success from a
completed command when required removal evidence is missing.
© SethGammon · MIT · SethGammon/Citadel