mcpbeat Sign in

Prompt Refactor Agent Skill

Compatibility alias for behavior-preserving prompt artifact cleanup. Routes refactoring to hve-builder refactor mode.

574 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1313
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/microsoft/hve-core --skill prompt-refactor

The instruction itself

9 sections, as written by the author

Prompt Refactor Compatibility Skill

Goal

Preserve legacy prompt-refactor activation while simplifying approved prompt-engineering artifacts through the hve-builder refactor route and its independent quality gates.

Flow

  • Translate promptFiles to existing targets and resolve the behavior that must remain unchanged.
  • When requirements are omitted, use the HVE Builder baseline review to derive evidence-backed cleanup objectives.
  • Activate hve-builder with mode=refactor, the approved write boundary, requirements, and any caller-owned evidence root.
  • Return the HVE Builder static verdict, behavior-test fidelity and verdict, validation result, and overall outcome.

Inputs

  • promptFiles: existing prompt-engineering artifacts to refactor
  • requirements: optional cleanup objectives, constraints, and preserved behavior
  • evidenceRoot: optional caller-owned HVE Builder evidence path

Success Criteria

  • The approved targets are simpler without unintended behavior change.
  • Static review, behavior testing, and host validation pass.
  • Source changes stay inside the approved write boundary.
  • The returned overall outcome is unchanged from hve-builder.

Constraints

  • Do not dispatch retired named lifecycle workers.
  • Do not create a second orchestration loop or sandbox contract.
  • Route a requested type change, artifact split, or new support artifact back through HVE Builder scope approval.

Stop Rules

  • Stop Pass only when the HVE Builder refactor route passes every required gate.
  • Preserve Revise, Deferred, or Blocked and its rerun condition.
  • Ask when preserved behavior or write scope cannot be inferred safely.

Handoff

Use prompt-analyze for read-only follow-up review and prompt-builder when the requested work intentionally changes behavior or creates artifacts.

Final Response Contract

Return targets, changed files, refactor rationale, static verdict, behavior-test fidelity and verdict, validation result, overall outcome, evidence links, and next action.

Other skills for the same job

different authors, same section of the catalogue
Gemini
by softaworks
×2

Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and coding.

5k tokens
Claude Skills
by ComeOnOliver
×2

Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates.

13k tokens scripts
Backend Atomic Commit
by ComeOnOliver
×1

> Pedantic backend pre-commit and atomic commit Skill for Django/Optimo-style repos. Enforces local AGENTS.md / CLAUDE.md, pre-commit hooks, .security/* helpers, and Monty’s backend engineering taste – with no AI signatures in commit messages.

14k tokens
Safe Edit
by ComeOnOliver
×1

Automatically backs up files, saves diffs, uses agents/skills, and ensures modular code (<200 lines) before any implementation. Use this skill for ALL code changes to ensure safe, reversible, and clean implementations.

11k tokens
Sharing Skills
by ComeOnOliver
×1

Use when you've developed a broadly useful skill and want to contribute it upstream via pull request - guides process of branching, committing, pushing, and creating PR to contribute skills back to upstream repository

4k tokens
Od Code Migration
by nexu-io

Default reference pipeline for the code-migration taskKind — code-import → design-extract → token-map → rewrite-plan → patch-edit ↔ build-test devloop → diff-review → handoff.

4k tokens
Review Agent Setup
by wshobson

Configure human-in-the-loop gating for AI agent review actions in Claude Code. Use when setting up a project where an agent may post PR reviews, comments, merges, or edit CI configuration, and you want a cryptographically auditable approval trail with Cedar-enforced gates.

1k tokens
Auto Updater
by anthropics
vendor

> Check installed community skills for updates. Shows a diff and requires explicit approval before applying. Use when the user says "check for updates", "update my skills", "anything new for my installed skills", or when invoked from the registry-sync agent.

2k tokens

How to use it

Copy the folder

Take microsoft/prompt-refactor from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.