okhp3-repository-organizer

Profiles content-first Git repositories and plans approval-gated cross-platform reorganizations.

1|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/OKHP3/refoldec --skill okhp3-repository-organizer-okhp3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: okhp3-repository-organizer
Source: https://github.com/OKHP3/refoldec/tree/main/.agents/skills/okhp3-repository-organizer
Command: npx skills add https://github.com/OKHP3/refoldec --skill okhp3-repository-organizer-okhp3

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Repositories that grew organically from folders of notes, prompts, Word documents, PDFs, and research files often lack clear purpose, safe naming, and governance structure. This Skill inspects the evidence before changing anything, explains what the repository is for, and produces a safe, reversible reorganization plan instead of forcing an application template onto mixed content. ## Core Features & Use Cases - Evidence-based profiling: Runs a read-only inventory script and separates confirmed, inferred, and unknown claims to assign a repository archetype with confidence levels. - Cross-platform naming gate: Applies an ASCII lowercase hyphen naming profile and detects Windows-reserved names, case-folded and Unicode-normalized collisions, and path-length violations before any rename. - Approval-gated migration: Proposes a current-path to proposed-path mapping table, executes only approved moves with git mv, and verifies links, diffs, and portability diagnostics afterward. - Use Case: You have a local Git repository full of Markdown notes, paired DOCX/PDF exports with version suffixes, and filenames with spaces and Unicode. Use this Skill to profile the repository, design a topic-based structure, and execute a verified migration plan that survives Windows, macOS, Linux, GitHub URLs, and different shells. ## Quick Start Scan this local Git repository, determine what it is for, check its filenames for cross-platform portability, and prepare an approval-gated reorganization plan without changing any files yet.

Frequently Asked Questions about okhp3-repository-organizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize a Git repository full of notes and documents?▼

Start with a read-only inventory of files, extensions, governance files, and Git history, then write an evidence-backed profile separating confirmed, inferred, and unknown claims. Propose a target structure and an approval-gated move table before executing any changes with git mv.

How to rename repository files safely across Windows, macOS, and Linux?▼

Use ASCII lowercase names with single hyphens and one lowercase extension, avoiding spaces, Unicode punctuation, and Windows-reserved device names. Check case-folded and Unicode-normalized collisions across full paths, and use a two-step temporary git mv for case-only renames on case-insensitive filesystems.

What governance files should a content repository have?▼

A purpose-and-map README.md is the primary orientation surface, with AGENTS.md added only when agents will work in the repository. CHANGELOG.md, LIFECYCLE.md, MIGRATION.md, CLAUDE.md, .agents/, .kit/, and .github/ are conditional on observed use; empty placeholder scaffolding is not governance.

Does the inventory script modify or rename any files?▼

No, the bundled inventory_repo.py script is strictly read-only. It reports file counts, extensions, governance files, naming and portability violations, text headings, and duplicate candidates as JSON, treating diagnostics as findings for a plan rather than permission to rename.

When should I not reorganize a repository automatically?▼

Never execute structural changes without explicit approval of the exact move set; requests to clean up or organize do not imply execution approval. Also avoid deleting suspected duplicates until size and SHA-256 evidence is reviewed and the owner explicitly authorizes deletion.

How are duplicate files detected before cleanup?▼

Duplicates are identified only as exact size and SHA-256 matches when the inventory script runs with the --hash flag. Hash evidence supports analysis but never authorizes deletion; options include retaining both with clearer names, archiving one, or recording a canonical relationship.