g-refactor SKILL.md skillA

g-refactor from onlygian/g-forge is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add onlygian/g-forge/g-refactor@git:20261028.4cf571d

Pins git:20261028.4cf571d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
onlygian/g-forge
Path
skills/g-refactor/SKILL.md
Versions recorded
6
Latest version
git:20261028.4cf571d, committed Oct 28, 2026
First version recorded
Jun 29, 2026
Size
9,935 bytes
Repository stars
4
License
GPL-3.0

Guided refactor workflow — identify target, pre-analyse, spec, approve, execute, review. Accepts a scope path, an audit milestone file, or runs interactively. Safe-by-default: checks test coverage before execution and runs the full review gate after.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

**Announce:** "Using g-refactor to run the guided refactor workflow."

You orchestrate the refactor pipeline. You do not write code yourself — you coordinate spec-writer, refactor-executor, and the review gate.

## Step 1 — Identify the target

**If the argument is a milestone file** (e.g. `g-docs/milestones/M-audit-2025-05.md`):
- Read the milestone file.
- Print the P0 and P1 task tables.
- Ask: "Which task(s) do you want to refactor in this session? Enter task number(s) or **all P0** / **all P1**."
- Wait for the answer. Set `targets: [list of selected rows]`.

**If the argument is a path** (e.g. `src/services/UserService.ts` or `src/services/`):
- Set `targets: [path]`.
- Skip the milestone prompt.

**If no argument was provided**, ask:
> "What do you want to refactor? Options:
> a) Path or file — e.g. `src/services/UserService.ts`
> b) Load findings from an audit — e.g. `g-docs/milestones/M-audit-2025-05.md`
> c) Describe what to improve in plain English"

Wait for the answer and resolve to a concrete target list before continuing.

## Step 2 — Gather context

For each target:

1. If target is a file: read it fully.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add onlygian/g-forge/g-refactor@sha256:28f83b5b84497760

The line at the top of this page pins the label git:20261028.4cf571d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kcufszwq5khmfeve.svg)](https://markdownregistry.com/a/art_kcufszwq5khmfeve)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jun 29, 2026 and Oct 28, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20261028.4cf571d latest2026-10-28 4cf571d 9,935 BA view · diff
git:20260902.43671e42026-09-02 43671e4 9,930 BA view · diff
git:20260831.81b585b2026-08-31 81b585b 8,780 BA view · diff
git:20260830.9dd49c42026-08-30 9dd49c4 8,595 BA view · diff
git:20260722.4b869222026-07-22 4b86922 7,502 BA view · diff
git:20260629.6a13b472026-06-29 6a13b47 7,566 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9935 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

onlygian/g-forge · 4 stars · license GPL-3.0 · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kcufszwq5khmfeve
GET https://markdownregistry.com/api/v1/resolve?ref=onlygian/g-forge/g-refactor
GET https://markdownregistry.com/api/v1/blob/28f83b5b844977609d5ffe83e0552f80cf1e757c1af23f1abe6612a1ce84b9a6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from onlygian/g-forge

g-adr SKILL.md skill
onlygian/g-forge · skills/g-adr/SKILL.md · Capture an architectural decision record. First triages whether the decision merits an ADR or just a one-line entry in…
git:20260902.43671e4 · audit A · 4 stars
g-afk SKILL.md skill
onlygian/g-forge · skills/g-afk/SKILL.md · Autonomous milestone executor. Requires an approved plan. Runs all pending waves and auto-review with no between-step…
git:20260902.43671e4 · audit B · 4 stars
g-align SKILL.md skill
onlygian/g-forge · skills/g-align/SKILL.md · Brief-deviation check. Compares the project's actual trajectory (ROADMAP progress, recent commits, the observer…
git:20260831.81b585b · audit A · 4 stars
g-audit SKILL.md skill
onlygian/g-forge · skills/g-audit/SKILL.md · Full-codebase or targeted code quality audit. Detects SOLID violations, code smells, architectural drift, dead code…
git:20260722.4b86922 · audit A · 4 stars
g-blast-radius SKILL.md skill
onlygian/g-forge · skills/g-blast-radius/SKILL.md · Analyse the blast radius of a planned change. Inputs a file path, feature name, or list of paths from a plan. Outputs…
git:20260628.bdb8cad · audit A · 4 stars
g-brief SKILL.md skill
onlygian/g-forge · skills/g-brief/SKILL.md · Refresh g-docs/project_brief.md as the project evolves — reads current state, asks targeted questions, and updates the…
git:20260722.4b86922 · audit A · 4 stars
g-doc-review SKILL.md skill
onlygian/g-forge · skills/g-doc-review/SKILL.md · Documentation review gate. Dispatches the doc-reviewer agent on the changed file set to check documentation currency…
git:20260902.43671e4 · audit B · 4 stars
g-docs SKILL.md skill
onlygian/g-forge · skills/g-docs/SKILL.md · Documentation audit and generation. Scans for missing or stale code docs, missing README sections, undocumented env…
git:20260722.4b86922 · audit A · 4 stars
g-doctor SKILL.md skill
onlygian/g-forge · skills/g-doctor/SKILL.md · Read-only health diagnostics for G-Forge projects — 25 checks including hook registration, installed-copy drift, Check…
git:20261028.4cf571d · audit A · 4 stars
g-execute SKILL.md skill
onlygian/g-forge · skills/g-execute/SKILL.md · Execute an approved wave plan by dispatching parallel subagents per wave. Use after /g-plan is approved, or to resume a…
git:20261028.4cf571d · audit A · 4 stars
g-forecast SKILL.md skill
onlygian/g-forge · skills/g-forecast/SKILL.md · Run scope-realism analysis and premortem on an approved-or-pending plan. Outputs a complexity score, a quantified…
git:20260902.43671e4 · audit A · 4 stars
g-help SKILL.md skill
onlygian/g-forge · skills/g-help/SKILL.md · Context-aware help. With no argument, reads current project state and tells you where you are and what to do next, plus…
git:20261028.4cf571d · audit A · 4 stars

Every file in onlygian/g-forge

Browse by kind, by grade A, or by owner.