skills.rest
nklisch
nklischCOMMUNITY
Explore all skills by this author →
GitHub

bold-refactor

Analyze codebases and generate architectural redesign proposals with design documents.

7|4|Updated Mar 2, 2026
Search Tags:#design#architecture#refactoring#abstraction#code#conceptual-lenses
One-click install
npx skills add https://github.com/nklisch/skills --skill bold-refactor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bold-refactor
Source: https://github.com/nklisch/skills/tree/main/plugins/workflow/skills/bold-refactor
Command: npx skills add https://github.com/nklisch/skills --skill bold-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Existing codebases often suffer from hidden complexity and missed architectural opportunities, making incremental refactoring insufficient for true improvement.

Core Features & Use Cases

  • Conceptual Lens Analysis: Scans the project using lenses such as elimination, unification, and inversion to surface bold redesign ideas.
  • Provocative Suggestions: Generates 3‑5 high‑impact architectural proposals, each linked to a specific lens, with thesis, impact, and cost analysis.
  • Design Document Production: Crafts a detailed design specification ready for the implement or implement‑orchestrator skills, including exact file paths, interfaces, and acceptance criteria.
  • Interactive Dialogue: Engages the user to refine, combine, and prioritize suggestions before finalizing the design.

Quick Start

Ask bold‑refactor to analyze the repository and produce bold architectural redesign suggestions.

Frequently Asked Questions about bold-refactor

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

FAQPage Schema
How do I propose bold architectural abstractions to simplify a complex codebase?▼

To propose bold architectural abstractions, scan the project using conceptual lenses like elimination, unification, and inversion to surface high-impact redesign ideas. This generates 3-5 provocative suggestions with thesis, impact, and cost analysis for complex codebases.

When is incremental refactoring insufficient for improving an existing codebase?▼

Incremental refactoring is insufficient when existing codebases suffer from hidden complexity and missed architectural opportunities. In these cases, a high-level redesign using conceptual lens-driven suggestions is needed to reveal and transform the underlying architecture.

How do I generate a design document for a high-level code redesign?▼

Generate a design document by refining provocative architectural suggestions through interactive dialogue. The process crafts a detailed design specification including exact file paths, interfaces, and acceptance criteria ready for implementation.

Can I prioritize and combine architecture proposals before finalizing a design document?▼

Yes, you can prioritize and combine architecture proposals. The interactive dialogue engages the user to refine, combine, and prioritize the 3-5 high-impact architectural suggestions before finalizing the detailed design specification.

Does architectural redesign support downstream implementation and orchestration agents?▼

Yes, architectural redesign supports downstream implementation by producing a detailed design document consumable by implement and implement-orchestrator agents. The specification includes exact file paths, interfaces, and acceptance criteria.

Related Skills

Explore More Software Engineering Skills→
telum-aitelum-ai
2

project-scan

Surveys brownfield codebases to map architecture, technologies and epic areas.

Official
Intermediate
nklischnklisch
7

design

Generate design documents specifying interfaces, file paths, and acceptance criteria.

Community
Advanced
nklischnklisch
7

autopilot

Execute multi-phase software roadmaps with autonomous design, testing, and refactoring.

Community
Advanced
rom-orlovichrom-orlovich

code-refactoring

Refactor Python codebases incrementally with tests to preserve behavior.

Community
Advanced