kata-skill-implement

To automate skill authoring and documentation sync, you orchestrate widget, tool, and script creation while consolidating SKILL.md and references. This process scans for gap signals between declared components and disk contents, then delegates implementation tasks to resolve mismatches.

The best way to detect and reconcile filesystem gaps is running a structured implementation workflow that identifies mismatches between declared widgets, tools, scripts, references, and actual disk contents, including placeholder-only SKILL.md sections and empty files.

Agent delegation works by routing widget creation to a frontend agent and tool or Python script work to a Python agent, while keeping SKILL.md and references authorship in-house. This targeted delegation ensures specialized components are built by the appropriate agents.

To validate filesystem alignment after generating missing components, run an iterative plan, delegation, consolidation, and validation cycle. This workflow escalates after bounded retries if gaps persist, ensuring final disk contents match declared SKILL.md specifications.

Yes, you can consolidate SKILL.md and references when placeholders are out of sync by running a gap discovery workflow. It detects placeholder-only sections and empty files, delegates the implementation work, then resolves and updates the documentation to match.

Limitations of delegating skill authoring tasks include bounded retries before escalation, meaning persistent gaps may require manual intervention. Additionally, the orchestration workflow specifically delegates only widget and Python work, retaining documentation authoring in-house.