# Update Docs

> Update durable docs when explicitly requested or when current work changes behavior, exposes stale instructions, establishes an operational pattern, or yields reusable research guidance.

- Skill: `marin-community/update-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add marin-community/update-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marin-community/update-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: marin-community (https://skillmd.com/u/marin-community)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marin-community/update-docs

---


# Skill: Update Docs

Use this when a task changes behavior, reveals stale instructions, creates a new
operational pattern, or produces guidance that should survive outside the issue
thread.

## What to Update

- User-facing docs when behavior or configuration changes.
- Operational docs when commands, service setup, dashboards, alerts, or recovery
  procedures change.
- Skill docs when an agent workflow becomes reusable.
- Experiment reports or indexes when the work produces durable research
  findings.

Prefer editing the nearest existing doc over adding a new one. Add a new doc
only when the topic lacks a natural home or would make an existing page
unfocused.

## Content Rules

- Describe current behavior, not aspiration.
- Include exact commands and paths for operational procedures.
- Remove or correct stale instructions rather than adding caveats around them.
- Keep broad docs concise; put detailed run notes in the existing issue, W&B
  report, or durable session channel.

## Done Criteria

- Docs and code agree for the changed behavior.
- The next agent or human can find the authoritative procedure without reading
  the whole issue thread.
- Any generated guidance is generalized enough to reuse and specific enough to
  act on.

## Related Skills

Follow `.agents/skills/writing-style/SKILL.md` for writing-style guidance.