skill-optimizer

Audit and rewrite SKILL.md files for installed Claude skills using the SOE-v2 protocol.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/nmoralescyber/claude-skill-optimization --skill skill-optimizer-nmoralescyber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-optimizer
Source: https://github.com/nmoralescyber/claude-skill-optimization/tree/main/skill-optimizer
Command: npx skills add https://github.com/nmoralescyber/claude-skill-optimization --skill skill-optimizer-nmoralescyber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Optimizer fixes misalignment and quality gaps across installed Claude skills by auditing and rewriting SKILL.md files according to the SOE-v2 protocol, backed by a robust backup and logging system.

Core Features & Use Cases

  • Calibrates SKILL.md against defined standards, runs diagnostic probes, and iterates improvements with a formal 4-axis rubric.
  • Auto-backups original SKILL.md to outputs/skill-backups before any rewrite, with an audit log for traceability.
  • Scales to large libraries by prioritizing skills via ROI signals and applying structured rework across multiple skills in batches.

Quick Start

Audit my installed skill library and generate an optimization plan using the Skill Optimizer.

Frequently Asked Questions about skill-optimizer

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

FAQPage Schema
How do I audit and rewrite SKILL.md files to improve trigger accuracy?

To audit and rewrite SKILL.md files, use the Skill Optimizer to calibrate defined standards, run diagnostic probes, and apply deliberate-practice rewrites using the SOE-v2 protocol. This process enforces local-only changes and records modifications in an audit log for traceability.

What is the SOE-v2 protocol for skill optimization?

The SOE-v2 protocol is a structured methodology for skill optimization that uses calibration, diagnostic probes, deliberate-practice rewrites, and safe backups. It improves trigger accuracy and instructions in SKILL.md files through a formal 4-axis rubric.

Can I optimize a large local skill library without losing my original instructions?

Yes, you can scale to large local skill libraries by prioritizing skills via ROI signals and applying batch reworks. The optimizer automatically backs up original SKILL.md files to outputs/skill-backups before any rewrite to prevent data loss.

How do I track changes made during SKILL.md file optimization?

You track changes by reviewing the outputs/skill-optimizer-log.md file. The optimizer automatically records all modifications and rewrites in this audit log to ensure full traceability and accountability across your local skill library.

Does skill optimization require external dependencies or cloud access?

No, skill optimization is entirely self-contained and enforces local-only changes without requiring external dependencies. It operates directly on your local skill library to audit and rewrite files safely offline.