How do I install the Repair skill?

Run npx skillmds@latest add tomevault-io/repair in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Repair skill do?

ultra-codex-init 자동 복구 및 문제 해결. Hook 실패, 문서 손상, 설정 오류를 진단하고 수정합니다. Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.

Is Repair safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Repair?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Repair free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Repair?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Repair by tomevault-io — Agent Skill

Name: Repair
Author: tomevault-io

File contents

/repair - System Recovery

Usage

/repair [mode] [options]

Mode	Description
`--diagnose`	문제 진단만 수행 (기본)
`--auto`	자동 복구 실행
`--hooks`	Hook 관련 문제만 수정
`--docs`	문서 구조만 수정
`--config`	설정 파일만 수정
`--full`	전체 복구 (모든 항목)
`--report`	복구 보고서 생성

Workflow

1. 시스템 진단 → 2. 문제 분류 (CRITICAL/WARNING/INFO) → 3. 자동 복구 → 4. 수동 복구 안내 → 5. 보고서

Diagnosable Issues

Hook Issues

Problem	Description	Auto-Fix
`permission_denied`	실행 권한 없음	`chmod +x`
`file_missing`	Hook 파일 누락	기본 템플릿 복원
`syntax_error`	스크립트 문법 오류	Manual
`dependency_missing`	의존성 누락	Manual

Document Issues

Problem	Description	Auto-Fix
`missing_directory`	docs/, phases/, sprints/ 누락	`mkdir -p`
`missing_required`	PROGRESS.md, CONTEXT.md 누락	기본 문서 생성
`broken_links`	내부 링크 손상	링크 수정
`invalid_format`	마크다운 형식 오류	Manual

Configuration Issues

Problem	Description	Auto-Fix
`invalid_json`	settings.json 문법 오류	기본값 복원
`missing_section`	필수 섹션 누락	누락 섹션 추가
`invalid_reference`	존재하지 않는 파일 참조	Manual
`deprecated_setting`	지원 종료 설정	설정 마이그레이션

Quick Commands

Task	Command
Hook 권한 일괄 수정	`/repair --hooks`
문서 구조 복구	`/repair --docs`
설정 검증 및 수정	`/repair --config`
전체 진단 + 자동 복구	`/repair --full`
진단만 수행	`/repair --diagnose`
복구 후 검증	`/repair --auto && /validate --full`

Integration

Target	Trigger	Action
`/validate`	validate 실패 시	`/repair --auto` → `/validate --full`
Error Recovery Hook	Hook 실패 시	`auto_recover_on_hook_failure: true`
`quality-gate`	Pre-commit 실패 시	`quality-gate pre-commit \|\| /repair --auto`

Configuration

{
  "recovery": {
    "enabled": true,
    "auto_recover_on_hook_failure": true,
    "max_retry_count": 3,
    "log_retention_days": 7,
    "critical_hooks": ["pre-tool-use-safety.sh"],
    "auto_fixable": { "hook_permissions": true, "missing_directories": true, "log_rotation": true },
    "manual_required": { "missing_docs": ["PROGRESS.md", "CONTEXT.md"], "config_validation": true }
  }
}

Error Codes

Code	Meaning
0	All repairs successful
1	Some repairs needed manual action
2	Critical errors (repair failed)
3	System in unrecoverable state

Command	Purpose
`/validate`	System validation
`/init`	Initialize/restore configuration
`/agile-sync`	Sync documentation

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: repairdescription: ultra-codex-init 자동 복구 및 문제 해결. Hook 실패, 문서 손상, 설정 오류를 진단하고 수정합니다. Use when this capability is needed.---# /repair - System Recovery## Usage```bash/repair [mode] [options]```| Mode | Description ||------|-------------|| `--diagnose` | 문제 진단만 수행 (기본) || `--auto` | 자동 복구 실행 || `--hooks` | Hook 관련 문제만 수정 || `--docs` | 문서 구조만 수정 || `--config` | 설정 파일만 수정 || `--full` | 전체 복구 (모든 항목) || `--report` | 복구 보고서 생성 |## Workflow```1. 시스템 진단 → 2. 문제 분류 (CRITICAL/WARNING/INFO) → 3. 자동 복구 → 4. 수동 복구 안내 → 5. 보고서```## Diagnosable Issues### Hook Issues| Problem | Description | Auto-Fix ||---------|-------------|----------|| `permission_denied` | 실행 권한 없음 | `chmod +x` || `file_missing` | Hook 파일 누락 | 기본 템플릿 복원 || `syntax_error` | 스크립트 문법 오류 | Manual || `dependency_missing` | 의존성 누락 | Manual |### Document Issues| Problem | Description | Auto-Fix ||---------|-------------|----------|| `missing_directory` | docs/, phases/, sprints/ 누락 | `mkdir -p` || `missing_required` | PROGRESS.md, CONTEXT.md 누락 | 기본 문서 생성 || `broken_links` | 내부 링크 손상 | 링크 수정 || `invalid_format` | 마크다운 형식 오류 | Manual |### Configuration Issues| Problem | Description | Auto-Fix ||---------|-------------|----------|| `invalid_json` | settings.json 문법 오류 | 기본값 복원 || `missing_section` | 필수 섹션 누락 | 누락 섹션 추가 || `invalid_reference` | 존재하지 않는 파일 참조 | Manual || `deprecated_setting` | 지원 종료 설정 | 설정 마이그레이션 |## Quick Commands| Task | Command ||------|---------|| Hook 권한 일괄 수정 | `/repair --hooks` || 문서 구조 복구 | `/repair --docs` || 설정 검증 및 수정 | `/repair --config` || 전체 진단 + 자동 복구 | `/repair --full` || 진단만 수행 | `/repair --diagnose` || 복구 후 검증 | `/repair --auto && /validate --full` |## Integration| Target | Trigger | Action ||--------|---------|--------|| `/validate` | validate 실패 시 | `/repair --auto` → `/validate --full` || Error Recovery Hook | Hook 실패 시 | `auto_recover_on_hook_failure: true` || `quality-gate` | Pre-commit 실패 시 | `quality-gate pre-commit \|\| /repair --auto` |## Configuration```json{ "recovery": { "enabled": true, "auto_recover_on_hook_failure": true, "max_retry_count": 3, "log_retention_days": 7, "critical_hooks": ["pre-tool-use-safety.sh"], "auto_fixable": { "hook_permissions": true, "missing_directories": true, "log_rotation": true }, "manual_required": { "missing_docs": ["PROGRESS.md", "CONTEXT.md"], "config_validation": true } }}```## Error Codes| Code | Meaning ||------|---------|| 0 | All repairs successful || 1 | Some repairs needed manual action || 2 | Critical errors (repair failed) || 3 | System in unrecoverable state |## Related| Command | Purpose ||---------|---------|| `/validate` | System validation || `/init` | Initialize/restore configuration || `/agile-sync` | Sync documentation |---> Converted and distributed by [TomeVault](https://tomevault.io/claim/tygwan) — claim your Tome and manage your conversions.

Frequently asked questions

Repair