split-skill

What problem does it solve?

This Skill reduces oversized SKILL.md files by extracting coherent sub-capabilities into child skills or linking to existing skills, preserving full functionality while keeping each skill under the 200-line guideline. It prevents unnecessary duplication, enforces security scans before splitting, and codifies safe, repeatable split and delegation workflows.

Core Features & Use Cases

• Discover-and-Link First: Scans the skill library to find existing skills that can be linked or marginally adapted instead of creating new children.
• Type A & B Extraction: Supports both phase/feature extraction (Type A) and shared-capability extraction across multiple parents (Type B), with clear contracts and AGENTS.md updates.
• Validation and Safety: Invokes secure-* scanners, verifies line counts, runs agentskills validate, and generates precise commit metadata to ensure regressions are avoided.
• Use Case: While maintaining a large improve-skills file, use this Skill to extract a repeated "link-check" flow into a shared child skill and update all callers automatically.

Quick Start

Analyze the oversized SKILL.md at .agents/skills/<parent> and produce a recommended action plan that links to existing skills when possible or extracts a new child with a suggested name, inputs, outputs, and commit message.