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
SKILL.md, read when the skill is used
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1 313
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.

2.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.

2k 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.

5.3k 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.

1.8k 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

1.2k 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.

384 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.

1.4k 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.

2.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.