refactor — for Claude Code refactor, psc-comet, community, for Claude Code, ide skills, Behavior-preserving, restructuring, different, structure, produces

v0.1.0
GitHub

Sobre este Skill

Cenario recomendado: Ideal for AI agents that need behavior-preserving restructuring. the goal is a different structure that produces identical. Resumo localizado: # Refactor Skill Behavior-preserving restructuring. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

Recursos

Behavior-preserving restructuring. The goal is a different structure that produces identical
What Claude Gets Wrong Without This Skill
The Behavior Contract
The One-Change Rule
One structural change at a time:

# Tópicos principais

for Claude Code Behavior-preserving restructuring different structure produces
andrem-sec andrem-sec
[1]
[0]
Atualizado: 4/2/2026

Skill Overview

Start with fit, limitations, and setup before diving into the repository.

Cenario recomendado: Ideal for AI agents that need behavior-preserving restructuring. the goal is a different structure that produces identical. Resumo localizado: # Refactor Skill Behavior-preserving restructuring. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

Por que usar essa habilidade

Recomendacao: refactor helps agents behavior-preserving restructuring. the goal is a different structure that produces identical. Refactor Skill Behavior-preserving restructuring. This AI agent skill supports Claude

Melhor para

Cenario recomendado: Ideal for AI agents that need behavior-preserving restructuring. the goal is a different structure that produces identical.

↓ Casos de Uso Práticos for refactor

Caso de uso: Behavior-preserving restructuring. The goal is a different structure that produces identical
Caso de uso: What Claude Gets Wrong Without This Skill
Caso de uso: The Behavior Contract

! Segurança e Limitações

  • Limitacao: Do not batch. Do not "while I'm in here" add improvements. Do not rename AND restructure in one change.
  • Limitacao: Remove duplication Same logic in 3+ places — but only if the logic is genuinely identical, not just similar
  • Limitacao: Do not refactor code you do not understand. Read it until you can state its behavior contract before touching it.

About The Source

The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Demo Labs

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ e etapas de instalação

These questions and steps mirror the structured data on this page for better search understanding.

? Perguntas frequentes

O que é refactor?

Cenario recomendado: Ideal for AI agents that need behavior-preserving restructuring. the goal is a different structure that produces identical. Resumo localizado: # Refactor Skill Behavior-preserving restructuring. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

Como instalar refactor?

Execute o comando: npx killer-skills add andrem-sec/psc-comet. Ele funciona com Cursor, Windsurf, VS Code, Claude Code e mais de 19 outros IDEs.

Quais são os casos de uso de refactor?

Os principais casos de uso incluem: Caso de uso: Behavior-preserving restructuring. The goal is a different structure that produces identical, Caso de uso: What Claude Gets Wrong Without This Skill, Caso de uso: The Behavior Contract.

Quais IDEs são compatíveis com refactor?

Esta skill é compatível com Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use a CLI do Killer-Skills para uma instalação unificada.

refactor tem limitações?

Limitacao: Do not batch. Do not "while I'm in here" add improvements. Do not rename AND restructure in one change.. Limitacao: Remove duplication Same logic in 3+ places — but only if the logic is genuinely identical, not just similar. Limitacao: Do not refactor code you do not understand. Read it until you can state its behavior contract before touching it..

↓ Como instalar este skill

  1. 1. Abra o terminal

    Abra o terminal ou linha de comando no diretório do projeto.

  2. 2. Execute o comando de instalação

    Execute: npx killer-skills add andrem-sec/psc-comet. A CLI detectará sua IDE ou agente automaticamente e configurará a skill.

  3. 3. Comece a usar o skill

    O skill já está ativo. Seu agente de IA pode usar refactor imediatamente no projeto atual.

! Source Notes

This page is still useful for installation and source reference. Before using it, compare the fit, limitations, and upstream repository notes above.

Upstream Repository Material

The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Upstream Source

refactor

# Refactor Skill Behavior-preserving restructuring. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows. Behavior-preserving

SKILL.md
Readonly
Upstream Repository Material
The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.
Upstream Source

Refactor Skill

Behavior-preserving restructuring. The goal is a different structure that produces identical observable behavior.

What Claude Gets Wrong Without This Skill

Without refactor discipline, "refactoring" becomes a mix of restructuring, behavior changes, and new features in one pass. When something breaks, there is no way to know which change caused it. Tests that fail mid-refactor mean the scope was too large, but without the discipline to go one change at a time, the error is impossible to isolate.

The Behavior Contract

Before touching any code, state what it currently does in terms of observable behavior — inputs, outputs, side effects. This is the contract.

If the refactor changes any of these, it is not a refactor — it is a feature change or a bug fix. Handle those separately.

The One-Change Rule

One structural change at a time:

  • Extract a function
  • Rename a variable
  • Remove duplication
  • Flatten nesting
  • Extract a class
  • Move a module

Run tests after each. If they pass, continue. If they fail, the change broke something — revert it and understand why before proceeding.

Do not batch. Do not "while I'm in here" add improvements. Do not rename AND restructure in one change.

The Coverage Gate

Refactoring without tests is rearranging furniture in the dark. Before the first structural change:

  • Run the test suite
  • Check coverage
  • If coverage is below 80% on the code being refactored, stop and write tests first

This is not optional. Skipping it means the refactor cannot be verified.

Common Refactor Operations

OperationWhen to Use
Extract functionBlock of code used in 2+ places, or a block that has a single clear responsibility
RenameName does not reflect current purpose (this happens after behavior is understood, not before)
Remove duplicationSame logic in 3+ places — but only if the logic is genuinely identical, not just similar
Flatten nestingMore than 3 levels of nesting in a single function
Extract classA function or module has grown to handle 2+ distinct concerns
InlineAn abstraction that adds complexity without clarity — sometimes the direct version is better

Anti-Patterns

Do not refactor code you do not understand. Read it until you can state its behavior contract before touching it.

Do not refactor and fix bugs in the same pass. Fix first, then refactor.

Do not refactor code with no tests. Write tests first.

Do not "improve" variable names speculatively — rename only when you understand the current name is wrong.

Mandatory Checklist

  1. Verify test coverage was checked before any changes
  2. Verify the behavior contract was stated before any structural changes
  3. Verify only one structural change was made per test run
  4. Verify no test failures occurred without a full stop and reassessment
  5. Verify the full test suite passes after all changes
  6. Verify coverage did not regress
  7. Verify the behavior contract is still satisfied after all changes

Habilidades Relacionadas

Looking for an alternative to refactor or another community skill for your workflow? Explore these related open-source skills.

Ver tudo

openclaw-release-maintainer

Logo of openclaw
openclaw

Resumo localizado: 🦞 # OpenClaw Release Maintainer Use this skill for release and publish-time workflow. It covers ai, assistant, crustacean workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 333.8k
⑂ 0
Inteligência Artificial

widget-generator

Logo of f
f

Resumo localizado: Generate customizable widget plugins for the prompts.chat feed system # Widget Generator Skill This skill guides creation of widget plugins for prompts.chat. It covers ai, artificial-intelligence, awesome-list workflows. This AI agent skill supports Claude Code, Cursor, and

★ 149.6k
⑂ 0
Inteligência Artificial

flags

Logo of vercel
vercel

Resumo localizado: The React Framework # Feature Flags Use this skill when adding or changing framework feature flags in Next.js internals. It covers blog, browser, compiler workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 138.4k
⑂ 0
Navegador

pr-review

Logo of pytorch
pytorch

Resumo localizado: Usage Modes No Argument If the user invokes /pr-review with no arguments, do not perform a review. It covers autograd, deep-learning, gpu workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 98.6k
⑂ 0
Desenvolvedor