skill-optimizer

Analyze SKILL.md frontmatter, workflows, and resources to produce an optimization plan.

6|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/SummerSec/SumSec-Skills --skill skill-optimizer-summersec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-optimizer
Source: https://github.com/SummerSec/SumSec-Skills/tree/main/skills/skill-optimizer
Command: npx skills add https://github.com/SummerSec/SumSec-Skills --skill skill-optimizer-summersec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit and optimize agent skills with a structured, repeatable review process. It supports Path A (structured rewrite with user confirmation) and Path B (read-only session audit) and promotes progressive disclosure by moving detailed guidance into references. It ensures frontmatter validity, clean workflow definitions, and safe, testable changes across SKILL.md, references, and assets.

Core Features & Use Cases

  • Structured skill review: analyzes SKILL.md frontmatter, workflow steps, and resource layout.
  • Dual workflow modes: Path A for guided rewrites after user confirmation; Path B for read-only audits with comprehensive analysis.
  • Progressive disclosure: pushes detailed rules and templates into references and assets to keep SKILL.md concise.
  • Optimization planning: outputs a concrete plan with changes, rationale, and a clear confirmation step.
  • Quality and consistency checks: validates naming, scope, and link integrity across the skill package.
  • Use cases: onboarding new skills, auditing existing skills, and planning refactors.

Quick Start

Analyze a target skill and propose an optimization plan, then confirm before applying any changes.

Frequently Asked Questions about skill-optimizer

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

FAQPage Schema
How do I audit an agent skill for frontmatter and workflow optimization?

You can audit agent skills using a structured review process that analyzes SKILL.md frontmatter, workflow steps, and resource layout. It supports a read-only session mode that provides comprehensive analysis without modifying any files.

What is progressive disclosure in skill design and how do I apply it?

Progressive disclosure keeps SKILL.md concise by moving detailed rules and templates into references and assets. This skill identifies documentation restructuring opportunities and applies the file changes safely after explicit user confirmation.

How do I restructure a skill package without breaking link integrity?

To safely restructure a skill package, you must validate naming, scope, and link integrity across all files. This skill proposes a structured rewrite plan that includes a clear confirmation step before applying any modifications to prevent broken references.

Can I review an existing skill without applying any file modifications?

Yes, you can review an existing skill without modifications by using the read-only session audit mode. This evaluates frontmatter validity and workflow definitions to output a comprehensive optimization plan while keeping all original files completely untouched.

What is the best way to plan a refactor for an agent skill?

The best way to plan an agent skill refactor is to run a structured evaluation across triggers, workflows, and references. This generates a detailed optimization plan with suggested file changes and a readiness assessment before you commit to rewriting.