skills.rest
lgbarn
lgbarnCOMMUNITY
Explore all skills by this author →
GitHub

shipyard-writing-plans

Convert specs and requirements into XML-structured Shipyard implementation plans.

66|3|Updated Jan 31, 2026
Search Tags:#workflow#planning#task-decomposition#builder-agents#shipyard#plan-templates
One-click install
npx skills add https://github.com/lgbarn/shipyard --skill shipyard-writing-plans
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shipyard-writing-plans
Source: https://github.com/lgbarn/shipyard/tree/main/skills/shipyard-writing-plans
Command: npx skills add https://github.com/lgbarn/shipyard --skill shipyard-writing-plans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams convert a written spec, requirements, or design into a detailed, executable plan that builder agents can follow, reducing ambiguity and prep time before coding begins.

Core Features & Use Cases

  • Plan from specs: Generate a Shipyard-compatible, XML-structured plan that breaks a multi-step task into discrete tasks with defined files, steps, and verifications.
  • Task decomposition: Split complex work into bite-sized tasks with clear ownership and checkpoints.
  • Plan storage & reuse: Save plans to docs/plans/YYYY-MM-DD-<feature-name>.md for future reference and iteration.
  • Use Case: When you have a feature request or design, this skill outputs an actionable plan that guides engineers, testers, and docs writers.

Quick Start

Provide your multi-step specification to generate a plan and save it to the designated docs/plans path for review and execution.

Frequently Asked Questions about shipyard-writing-plans

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

FAQPage Schema
How do I turn feature specs into executable plans for builder agents?▼

Task decomposition breaks complex work into bite-sized tasks with clear ownership and checkpoints. It outputs XML-structured tasks with defined files, steps, and verifications, reducing ambiguity before coding begins.

How do I generate a multi-step implementation plan from a design document?▼

Plans are saved to docs/plans/YYYY-MM-DD-<feature-name>.md for future reference and iteration. This ensures your generated XML-structured task plans remain accessible for subsequent reviews and execution cycles.

Can I use task decomposition for parallel execution by builder agents?▼

Yes, you need a written spec, requirement, or feature idea to begin. The skill takes these multi-step specifications and decomposes them into actionable, XML-structured tasks without requiring additional prerequisite setup.

What is the best way to decompose multi-step tasks for parallel execution?▼

The skill decomposes work into discrete tasks with defined files, steps, and verifications within an XML structure. It does not support other plan formats or execution environments outside the Shipyard builder agent workflow.

Related Skills

Explore More Software Engineering Skills→
ryu-satoryu-sato

kiro-spec-tasks

Generate executable task plans from structured requirements and design documents.

Community
Advanced
OriNachumOriNachum
234

implement

Execute code changes and shell commands from plan files in docs/plan.

Community
Intermediate
lgbarnlgbarn
66

shipyard-executing-plans

Dispatch builder and reviewer agents to execute implementation plans with two-stage gates.

Community
Advanced
henrycashe26henrycashe26

to-issues

Break project plans and PRDs into vertical slice issues with acceptance criteria.

Community
Intermediate