skills.rest
ValorInvestigator
ValorInvestigatorCOMMUNITY
Explore all skills by this author →
GitHub

skill-optimizer

Audit and rewrite OpenClaw SKILL.md files for YAML validity and token efficiency.

1|Updated Feb 23, 2026
Search Tags:#token-efficiency#openclaw#reference-guidance#skill-optimization#workflow-audit#yaml-validation#deterministic-runbook
One-click install
npx skills add https://github.com/ValorInvestigator/claude-plugin-toolkit --skill skill-optimizer-valorinvestigator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-optimizer
Source: https://github.com/ValorInvestigator/claude-plugin-toolkit/tree/main/skills/skill-optimizer
Command: npx skills add https://github.com/ValorInvestigator/claude-plugin-toolkit --skill skill-optimizer-valorinvestigator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Keeps OpenClaw skills efficient by catching YAML issues, trimming token waste, and enforcing deterministic runbooks before publishing. Without this audit, skill loaders risk invalid YAML, bloated descriptions, and unpredictable workflows.

Core Features & Use Cases

  • 12-Point Audit: Scores SKILL.md and every reference against YAML validity, description clarity, workflow structure, token waste, and urgency markers, then rewrites the same content with those issues resolved.
  • Progressive Disclosure & Diff: Moves reference-worthy detail into auxiliary files, explains why each change improves efficiency, and delivers a before/after diff plus verification proof.
  • Use Case: Platform engineers preparing marketplace submissions run this optimizer to confirm each skill is deterministic, lean, and accompanied by clear guidance.

Quick Start

Request the Skill Optimizer to audit your OpenClaw SKILL.md, apply its 12-point checklist, and provide the rewritten version plus diff summary.

Frequently Asked Questions about skill-optimizer

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

FAQPage Schema
How do I audit OpenClaw skills for token efficiency and YAML validity?▼

To audit OpenClaw skills for token efficiency, apply a 12-point checklist that validates YAML, scores description clarity, trims token waste, and enforces deterministic workflows before rewriting the SKILL.md file.

What is progressive disclosure in skill optimization and when do I need it?▼

Progressive disclosure in skill optimization moves reference-worthy details into auxiliary files to reduce token bloat. You need it when preparing marketplace submissions to keep skill loaders lean and deterministic.

How do I fix invalid YAML in a SKILL.md file before publishing?▼

Fix invalid YAML in a SKILL.md file by running an audit that validates structure, backs up originals, rewrites the content to resolve parsing issues, and verifies the rewritten file parses correctly.

Can I use a workflow audit to make OpenClaw runbooks deterministic?▼

Yes, a workflow audit makes OpenClaw runbooks deterministic by scoring workflow structure, eliminating unpredictable execution paths, and rewriting the runbook with clear, enforced deterministic steps.

What is the best way to reduce token waste in OpenClaw skill descriptions?▼

The best way to reduce token waste in OpenClaw skill descriptions is auditing for bloated content, applying progressive disclosure to move details to auxiliary files, and rewriting with token savings verified.

Why does my SKILL.md fail to parse after manual edits?▼

SKILL.md parsing fails after manual edits due to invalid YAML syntax or structural bloat. An audit validates the YAML, backs up the original, rewrites the content, and verifies parsing to resolve errors.

Related Skills

Explore More Software Engineering Skills→
Pieverse-EngPieverse-Eng

mantle-tx-simulator

Prepare Mantle transaction simulation handoff packages with WYSIWYS reports.

Official
Advanced
pr-pmpr-pm
121

ci-test-claude-skill

Verify Claude skill installation paths, directory structure, and frontmatter parsing in CI pipelines.

Community
Basic
velzicomvelzicom

creating-skills

Guide creation and refinement of AI skills with SKILL.md structure and YAML frontmatter rules.

Official
Intermediate
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic