About

Imported from nickcrew/claude-cortex (skills/repo-cleanup/SKILL.md). Install upstream with npx skills add nickcrew/claude-cortex --skill repo-cleanup. Copyright stays with the author.

Repo Cleanup

Name: repo-cleanup
Author: nickcrew

Overview

Establish a safe, repeatable cleanup workflow for code, dependencies, docs, tests, and sprint artifacts. Minimize risk by validating usage, archiving before deletion, and verifying with tests.

When to Use

Repository bloat (generated artifacts, caches, unused files)
Dead code or unused dependencies suspected
Docs drifted from actual behavior
Tests are brittle, redundant, or mislocated
Sprint closure needs structured archiving

Avoid when:

Active incident response is ongoing
The target area lacks owners or rollback coverage

Quick Reference

Task	Load reference
Code cleanup	`skills/repo-cleanup/references/code-cleanup.md`
Dependency cleanup	`skills/repo-cleanup/references/deps-cleanup.md`
Docs cleanup	`skills/repo-cleanup/references/docs-cleanup.md`
Test cleanup	`skills/repo-cleanup/references/test-cleanup.md`
Sprint archive	`skills/repo-cleanup/references/archive-sprint.md`

Workflow

Define scope and safety mode (safe vs aggressive).
Capture baseline state (git status, key tests, backups).
Load the relevant reference file(s) for the target area.
Execute cleanup steps with usage checks before removal.
Validate changes (tests, build, lint, or doc checks).
Report outcomes (actions taken, risks, follow-ups).

Output

Summary of actions and files touched
Validation results and remaining risks
Follow-up recommendations or backlog items

Common Mistakes

Deleting without confirming usage or regenerability
Skipping baseline tests and rollback checkpoints
Removing dependencies without updating build/test scripts
Collapsing docs without preserving entry points

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/nickcrew-claude-cortex-repo-cleanup/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

nickcrew-claude-cortex-repo-cleanup.ocm.jsonjson

{
  "ocm": "1",
  "id": "nickcrew-claude-cortex-repo-cleanup",
  "kind": "skill",
  "name": "repo-cleanup",
  "description": "Use when a repository needs cleanup of dead code, build artifacts, unused dependencies, outdated docs, or stale tests - provides safe cleanup workflows, validation steps, and reporting templates for code, deps, docs, tests, and sprint archives.",
  "publisher": "nickcrew",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "archive-sprint",
      "cleanup-repo",
      "dead-code",
      "docs-cleanup",
      "remove-artifacts",
      "repo-cleanup",
      "test-cleanup",
      "unused-dependencies",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when a repository needs cleanup of dead code, build artifacts, unused dependencies, outdated docs, or stale tests - provides safe cleanup workflows, validation steps, and reporting templates for code, deps, docs, tests, and sprint archives."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/nickcrew/claude-cortex",
      "path": "skills/repo-cleanup/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/nickcrew/claude-cortex/blob/HEAD/skills/repo-cleanup/SKILL.md",
      "key": "nickcrew/claude-cortex/skills/repo-cleanup/SKILL.md"
    }
  },
  "instructions": "# Repo Cleanup\n\n## Overview\nEstablish a safe, repeatable cleanup workflow for code, dependencies, docs, tests, and sprint artifacts. Minimize risk by validating usage, archiving before deletion, and verifying with tests.\n\n## When to Use\n- Repository bloat (generated artifacts, caches, unused files)\n- Dead code or unused dependencies suspected\n- Docs drifted from actual behavior\n- Tests are brittle, redundant, or mislocated\n- Sprint closure needs structured archiving\n\nAvoid when:\n- Active incident response is ongoing\n- The target area lacks owners or rollback coverage\n\n## Quick Reference\n\n| Tas",
  "cost": {
    "context_tokens": 428
  }
}

Fetch it by URL: GET /api/v1/registry/nickcrew-claude-cortex-repo-cleanup/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.