shipyard-writing-skills

What problem does it solve?

This skill provides a structured, test-driven approach to authoring, validating, and deploying Claude skills by enforcing a RED-GREEN-REFACTOR workflow and consistent SKILL.md formatting.

Core Features & Use Cases

• Guided skill creation: ensures YAML frontmatter with name and description is present and validated.
• Testing discipline: applies a TDD cycle to skill documentation, including pressure scenarios and failure-recovery checks before deployment.
• Quality controls: enforces a stable directory structure, cross-reference guidelines, and deployment readiness checks.
• Use Case: a team adds a new skill directory, writes SKILL.md, runs the deployment checklist, and verifies the skill passes test scenarios before publishing.

Quick Start

1. Create a new directory under skills/ with a valid SKILL.md frontmatter describing the skill.
2. Include a concise description and an activation/instructions section per the guidelines.
3. Run the skill deployment checklist to validate before deployment.