skill_builder_agent

Review and refactor SKILL.md files with user confirmation for changes.

4|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/dewitt/swarm --skill skill-builder-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill_builder_agent
Source: https://github.com/dewitt/swarm/tree/main/skills/skill-architect
Command: npx skills add https://github.com/dewitt/swarm --skill skill-builder-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews, refactors, and optimizes the structure and instructions of agent skills within the workspace.

Core Features & Use Cases

  • Structured validation: Audits SKILL.md frontmatter to ensure required fields like name and description exist and are well-formed.
  • Safe refactoring prompts: Proposes modular split of large skill documents, with user confirmation before destructive changes.
  • Context-aware improvements: Incorporates user-provided research and contextual notes to refine skill instructions.

Quick Start

Review the current SKILL.md files using list_local_files and read_local_file, then propose and apply approved structural refactors with write_local_file.

Frequently Asked Questions about skill_builder_agent

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

FAQPage Schema
How do I refactor and optimize agent skill definitions?

Refactor agent skill definitions by auditing SKILL.md files, validating YAML frontmatter integrity, proposing modular splits, and writing approved structural changes to optimize instructions.

What is the best way to validate YAML frontmatter in SKILL.md files?

Validating YAML frontmatter requires auditing SKILL.md definitions to ensure required fields like name and description exist and are well-formed, preventing structural errors in agent skills.

Can I safely split large skill documents without losing existing instructions?

Safely split large skill documents by proposing modular refactors and coordinating destructive edits with user confirmation prompts before applying any changes via file write operations.

How do I review agent skills across a workspace directory?

Review agent skills across a workspace directory by using local file discovery and reading operations to analyze current SKILL.md definitions before proposing targeted structural refactors.

Does refactoring skill definitions require manual context input?

Refactoring skill definitions incorporates user-provided research and contextual notes to refine instructions, allowing you to manually input context for context-aware improvements to the skill structure.

Why should I not automate destructive edits when restructuring skill definitions?

Automating destructive edits bypasses safety prompts that coordinate changes with user confirmation, risking unintended data loss when applying modular refactors to existing skill definition files.