skill-writer

A source-backed workflow for creating, improving, registering, and validating agent skills.

30-Second Summary

This skill gives an agent a canonical workflow for skill creation and maintenance.

It routes create, update, synthesis, iteration, authoring, description optimization, and validation into ordered passes.

Use it when the output is an agent skill artifact rather than a generic prompt or documentation page.

1-Minute Read

What it is

A SKILL.md workflow for authoring and maintaining agent skills with source capture, reference architecture, precision passes, registration, and validation. It is built for structured skill artifacts rather than one-off prompt polishing.

When to use it

Use it when creating a new skill, updating an existing skill, synthesizing source material into a reusable workflow, or improving trigger precision from examples. It is strongest when there is enough source evidence to support the skill contract.

How to test it first

Ask the agent to classify the requested skill change as create, update, synthesize, or iterate before editing. Check whether it chooses the smallest adequate artifact shape and names the validation step.

Watch out

The workflow is deep and reference-heavy. Keep the target narrow, avoid copying provider-specific mechanics blindly, and do not treat it as a generic writing assistant.

Original sources

Original source GitHub repo skill-writer SKILL.md Sentry skills repo