dotfiles/.config/opencode/skills/doc-coverage/SKILL.md

name, description

name	description
doc-coverage	Documentation coverage checklist and update procedures — load when completing a feature or change set

When to Use

Load this skill when a feature or change set is nearing completion. Documentation is a completion gate — a task is not done until docs are handled.

Coverage Checklist

For every completed change set, verify documentation coverage:

1. README

• Does the README reflect the current state of the project?
• Are new features, commands, or configuration options documented?
• Are removed features cleaned up from the README?

2. Docs directory (docs/*)

• Are there relevant docs files that need updating?
• Do new features need their own doc page?
• Are API changes reflected in API documentation?

3. AGENTS.md / agent definitions

• Did this change alter workflow, policies, or agent behavior?
• If yes, update AGENTS.md or the relevant agent definition file.

4. Inline documentation

• Are complex functions/components documented with comments explaining why, not what?
• Are public APIs documented with parameter descriptions?

Update Procedure

1. Review the list of changed files and their purpose.
2. Identify which documentation files are affected.
3. Read the current state of each affected doc file.
4. Update docs to reflect the implemented changes — keep descriptions accurate and concise.
5. If a change removes functionality, remove or update the corresponding documentation.
6. If creating a new feature, add documentation in the most appropriate location.

Anti-patterns

• Never leave stale docs. If you changed behavior, the docs must change too.
• Never create placeholder docs. "TODO: document this" is not documentation.
• Never duplicate content across doc files. Link to the canonical source instead.
• Never wait for the user to ask. If docs need updating, update them proactively as part of the change set.

Delegation

• The librarian subagent is the specialist for documentation work.
• Lead should delegate doc coverage review to librarian after coder completes implementation.
• Librarian reads the changes, identifies doc gaps, and writes/updates documentation.