skills.rest
Acendas
AcendasOFFICIAL
Explore all skills by this author →
GitHub

ship-spec

Browse, search, and manage product specifications within Shipyard.

2|1|Updated Mar 9, 2026
Search Tags:#spec#feature#grep#references#epic#absorb#shipyard
One-click install
npx skills add https://github.com/Acendas/shipyard --skill ship-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship-spec
Source: https://github.com/Acendas/shipyard/tree/main/plugins/shipyard/skills/ship-spec
Command: npx skills add https://github.com/Acendas/shipyard --skill ship-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Browsing, searching, and updating a living product spec inside Shipyard is tedious without a unified tool. Ship-spec centralizes epics, features, and references, letting teams view, modify status, move items between epics, archive spec items, and absorb external documents in one place.

Core Features & Use Cases

  • Interactive Spec Browser: navigate epics, features, and references across the spec.
  • Status management: move features between statuses and epics with guardrails.
  • Reference absorption: attach external docs as spec references for context.
  • Full-text search: quickly locate items by ID, title, or term.

Quick Start

Start by typing /ship-spec and selecting a top-level epic to browse.

Frequently Asked Questions about ship-spec

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

FAQPage Schema
How do I navigate and browse a product spec inside Shipyard?▼

To navigate a product spec inside Shipyard, start the interactive browser to view top-level epics, drill into features, and access references using structured spec browsing operations.

How do I move a feature between epics or change its spec status?▼

You can change a feature's spec status and move it between epics using built-in guardrails, ensuring valid status transitions and maintaining structural integrity within the Shipyard product spec.

Can I attach external documents as references to my product spec?▼

Yes, you can absorb external documents into the product spec as references, attaching external context directly to epics and features to centralize project documentation within Shipyard.

What is the best way to search for a specific epic or feature in a living product spec?▼

The best way to search a living product spec is using full-text search to quickly locate epics, features, and references by their ID, title, or specific terms.

How do I archive completed work items in my product specification?▼

You can archive completed work items in your product specification by selecting the target features or epics and applying the archive operation to remove them from active spec browsing.

Do I need any external dependencies to manage my Shipyard spec?▼

No external dependencies are required to manage your Shipyard spec, as the tool operates standalone using built-in Read, Write, Edit, Grep, and Bash operations to handle deterministic spec tasks.

Related Skills

Explore More Product & Management Skills→
AcendasAcendas
2

ship-discuss

Guides feature discovery conversations from vague ideas to structured plans and specs.

Official
Advanced
sync-dev-orgsync-dev-org

sdd-status

Report SDD pipeline status and analyze downstream impact of spec changes.

Official
Intermediate
MarkusonMarkuson

bmad-sprint-planning

Parse epic and story markdown to generate sprint-status.yaml tracking files.

Community
Advanced
Biztactix-RyanBiztactix-Ryan

pm

Manage epics, stories, and tasks as markdown files in Git.

Community
Advanced