Skip to content
Development
Skill

/grace-refactor

Refactor GRACE 4 governed code while keeping .grace graph, verification, change scopes, and file-local anchors synchronized.

From plugin
grace-marketplace
26015 skills

Claude Code

$ npx -y skills add osovv/grace-marketplace --skill grace-refactor --agent claude-code

SKILL.md

grace-refactor.SKILL.md
name: grace-refactor
description: Refactor GRACE 4 governed code while keeping .grace graph, verification, change scopes, and file-local anchors synchronized.

<skill> <scope> Use this for rename, move, split, merge, extraction, or boundary cleanup work. Greenfield feature work should go through `grace-spec`, `grace-plan`, and `grace-execute`. </scope>

<must_do>

  • Resolve affected `M-*`, `DF-*`, and `V-M-*` anchors through `.grace/graph/index.xml` and `.grace/verification/index.xml`.
  • Check active `.grace/changes` for scope overlap before editing.
  • Preserve or update file-local `LINKS:`, module contracts, function contracts, and semantic blocks.
  • Update durable graph and verification artifacts only when the refactor intentionally changes boundaries, paths, or evidence.
  • Run targeted tests and `grace lint --path <project-root>` when available.

</must_do> </skill>

@osovv
Ships withgrace-marketplace

GRACE means Graph-RAG Anchored Code Engineering: a contract-first AI engineering methodology built around semantic markup, .grace XML artifacts, knowledge-graph navigation, assertions, scopes, and log-driven verification.

Stars on GitHub

Momentum

stars in total
260
Star history of osovv/grace-marketplace on GitHub, a chart by star-history.com

Other skills on grace-marketplace.

grace-ask

grace-ask

Answer questions about a GRACE 4 project by navigating .grace current-state artifacts and file-local semantic markup.

grace-cli

grace-cli

Operate the GRACE 4 CLI for .grace linting, status, module navigation, verification navigation, and file-local semantic markup.

grace-execute

grace-execute

Execute an approved GRACE 4 GraceChangePlan in sequential or parallel-safe mode with recovery-aware preflight and centralized…

grace-fix

grace-fix

Debug and fix issues in a GRACE 4 project using .grace semantic navigation, assertions, and verification evidence.

grace-init

grace-init

Bootstrap a Full GRACE 4 project by creating the canonical .grace context, graph, verification, and changes skeleton.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about grace-refactor.

Which coding agents can use grace-refactor?
grace-refactor installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.