help

Answers questions about Shipyard configuration and workflow by reading bundled plugin documentation.

1|1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/nearmap/shipyard --skill help-nearmap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: help
Source: https://github.com/nearmap/shipyard/tree/main/skills/help
Command: npx skills add https://github.com/nearmap/shipyard --skill help-nearmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users of the Shipyard plugin often need to know which command to run, what a SY_/ACLI_ setting controls, or which model an agent uses, without digging through the plugin's docs themselves. This Skill answers those questions by reading the plugin's own bundled documentation and citing the exact source file and line. ## Core Features & Use Cases - Documentation-grounded answers: Reads configuration.md, agent-guide.md, README, and usage/installation docs under ${CLAUDE_PLUGIN_ROOT} to answer questions accurately. - Source citation: Every answer is backed by a repo-relative file:line reference the user can open directly. - Live config inspection: For "what is my config actually set to" questions, it prefers the show_config tool over quoting documented defaults. - Use Case: A user asks "what model does the gate agent use?" and receives the setting name, the doc reference, and the consuming file, all read from the current plugin files rather than guessed. ## Quick Start Ask the help skill a question about Shipyard, such as which setting controls the gate agent's model or how to diagnose a failing ship run.

Frequently Asked Questions about help

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

FAQPage Schema
How do I find which Shipyard setting controls a behavior?▼

Ask the help skill your configuration question and it reads docs/configuration.md, the authoritative reference for every setting's layer, default, and meaning. For the value your repo actually resolves to, it calls the show_config tool instead of quoting a default.

How do I diagnose a Shipyard workflow problem?▼

The help skill consults the Diagnosis recipes section of agent-guide.md, which maps symptoms to causes and fixes. It cites the relevant file and line so you can verify the recommendation yourself.

Can the help skill answer questions about my own repository code?▼

No, it only reads the plugin's own bundled files and never touches the tracker or the target repo's code. Questions about your codebase or tickets belong to /sy:explain or the tracker skill.

What model does the Shipyard gate agent use?▼

The help skill answers this by reading both the models.agents.gate.model setting in docs/configuration.md and the consuming reference file, citing current file lines rather than assuming pinned line numbers.

What happens if the plugin docs do not cover my question?▼

The skill greps the plugin's skills/ and agents/ directories for the topic before giving up. If nothing answers it, the skill says so plainly and points to the nearest real doc rather than fabricating a variable name or behavior.