WorkspaceSkills
All skills
Documentation · INSTRUCTION-ONLY

Write a maintainable handoff

Help the next person operate and change a feature without reconstructing its history.

The workflow

When to use

Help the next person operate and change a feature without reconstructing its history.

Workflow

  1. Inspect the final implementation and public interfaces.
  2. Explain purpose, setup, configuration, common operations, and troubleshooting.
  3. Include tested examples, ownership, known limitations, and recovery actions.
  4. Keep transient conversation history out of the document.

Boundaries

Use only tools and data authorized for the task. Ask for missing requirements when they affect the result. Report what you verified and what you could not verify.

View and copy SKILL.md
SKILL.md
---
name: documentation-handoff
description: "Help the next person operate and change a feature without reconstructing its history."
license: CC0-1.0
metadata:
  author: "SI Editorial"
  version: "1"
---

# Write a maintainable handoff

## When to use
Help the next person operate and change a feature without reconstructing its history.

## Workflow
1. Inspect the final implementation and public interfaces.
2. Explain purpose, setup, configuration, common operations, and troubleshooting.
3. Include tested examples, ownership, known limitations, and recovery actions.
4. Keep transient conversation history out of the document.

## Boundaries
Use only tools and data authorized for the task. Ask for missing requirements when they affect the result. Report what you verified and what you could not verify.

## Try it
Write the handoff for a new remote MCP endpoint.

## Success looks like
An accurate operator guide with tested setup examples.

Try it with your agent

Write the handoff for a new remote MCP endpoint.

What a useful result looks like

An accurate operator guide with tested setup examples.

Practice before you connect