skill-refiner

Applies minimal evidence-backed patches to fix problems in existing Mavis skills.

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill skill-refiner-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-refiner
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/skill-refiner
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill skill-refiner-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Existing skills can contain wrong instructions, outdated steps, or missing edge cases, and fixing them without discipline leads to bloated rewrites or unjustified changes. This Skill enforces an evidence-driven, minimal-patch workflow so every skill edit traces back to a concrete, verified problem. ## Core Features & Use Cases - Evidence collection and attribution: Gathers concrete failure traces or user feedback, then classifies whether the fault lies in the skill text, the agent's behavior, or a changed environment before editing anything. - Minimal patch generation: Produces surgical old_string/new_string edits with documented problem, evidence, and rationale instead of full rewrites. - Mutable vs. immutable handling: Edits user and agent skills directly, while routing built-in or project skill changes through a worktree and merge request. - Use Case: A user reports that a deployment skill references a renamed CLI command. The Skill verifies the evidence, patches only the outdated command line, and re-reads the file to confirm the frontmatter and overall coherence survived. ## Quick Start Ask the agent to refine the skill named deployment-helper because its instructions reference a command that no longer exists.

Frequently Asked Questions about skill-refiner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix an outdated instruction in an existing skill?

Collect concrete evidence of the problem, read the current skill content, then apply a minimal old_string/new_string patch that fixes only the faulty instruction. Document the problem, evidence, and rationale with the edit.

When should I use skill-refiner instead of skill-creator?

Use skill-refiner only when an existing skill has a concrete, evidence-backed defect such as wrong steps or a missing edge case. Use skill-creator when building a brand-new skill from scratch.

Can I edit built-in or project skills directly at runtime?

No. Built-in skills under packages/local-runtime/assets/skills and version-controlled project skills are immutable at runtime. Note the required change and submit it through a worktree and merge request instead.

What should I do if the agent ignored correct skill instructions?

Do not change the skill. If the skill text is correct and the agent simply failed to follow it, that is an agent error, not a skill defect, so no patch is warranted.

What constraints apply when patching a skill file?

Never write secrets into skill files, keep the file under 100KB, preserve the frontmatter name and description fields, and never let skill-refiner modify its own SKILL.md. Every patch must trace to specific evidence.