skills.rest
gihwan-dev
gihwan-devCOMMUNITY
Explore all skills by this author →
GitHub

refactor-repo-skills

Audit and refactor SKILL.md files for conciseness and source-of-truth adherence.

Updated Jan 31, 2026
Search Tags:#code quality#documentation#refactoring#skills#auditing#repository management
One-click install
npx skills add https://github.com/gihwan-dev/claude-setup --skill refactor-repo-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactor-repo-skills
Source: https://github.com/gihwan-dev/claude-setup/tree/main/skills/refactor-repo-skills
Command: npx skills add https://github.com/gihwan-dev/claude-setup --skill refactor-repo-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the issue of overly verbose and complex SKILL.md files within a repository, making them difficult to understand and maintain. It automates the process of auditing and refactoring these skills to adhere to a source-of-truth principle.

Core Features & Use Cases

  • Skill Auditing: Analyzes SKILL.md files for verbosity, structure, and adherence to best practices.
  • Automated Refactoring: Rewrites the top candidates (or user-specified skills) to be more concise, moving detailed information to references or scripts.
  • Use Case: A developer can run this skill to automatically identify and clean up the most complex skill descriptions in the skills/ directory, ensuring consistency and maintainability across the project.

Quick Start

Use the refactor-repo-skills skill to audit all skills in the repository and refactor the top candidates.

Frequently Asked Questions about refactor-repo-skills

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

FAQPage Schema
How do I audit and refactor verbose skill documentation in my repository?▼

To audit and refactor verbose skill documentation, this skill analyzes `SKILL.md` files, scores verbosity and structural issues, and rewrites top candidates to ensure conciseness and adherence to source-of-truth principles.

What is the best way to enforce a source-of-truth principle in repository skills?▼

Enforcing a source-of-truth principle requires keeping `SKILL.md` files concise. This skill prioritizes moving detailed information into `references/` or `scripts/` directories, ensuring the main documentation remains streamlined and maintainable.

How do I clean up complex SKILL.md files across my project?▼

To clean up complex `SKILL.md` files, run this skill to automatically identify the most verbose descriptions in your `skills/` directory and refactor them for consistency, moving detailed implementation data to scripts or references.

Can I specify which skills to refactor instead of auditing the entire repository?▼

Yes, you can specify which skills to refactor. The skill identifies top verbosity candidates by default, but allows you to target and rewrite user-specified skills to keep the source of truth concise.

Does refactoring skills automatically update the generated files in the repository?▼

Generated files are updated via sync scripts only. The refactoring process ensures that moving detailed information to `references/` or `scripts/` triggers the necessary sync scripts to update generated files safely.

Related Skills

Explore More Software Engineering Skills→
Greenmamba29Greenmamba29

supply-chain-auditor

Audits supplier networks and procurement data for ESG and compliance risks.

Community
Advanced
sc30gswsc30gsw
11

update-docs

Extract documentation from package.json and .env.example into CONTRIB.md and RUNBOOK.md.

Community
Intermediate
randalmurphalrandalmurphal

Python Style Standards

Enforce Python style standards with ruff, pylint, and mypy.

Community
Advanced
outcomeengoutcomeeng
1

aligning

Identify factual conformance issues in SPX spec Markdown files.

Official
Advanced