workflow-docs-review

Refresh the Project Context Cache and apply minimal documentation updates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/hollis-labs/volon --skill workflow-docs-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-docs-review
Source: https://github.com/hollis-labs/volon/tree/main/plugins/workflows/skills/workflow-docs-review
Command: npx skills add https://github.com/hollis-labs/volon --skill workflow-docs-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures repository documentation stays aligned with the Project Context Cache (PCC) and repository state by performing targeted, minimal edits and optionally opening a PR, avoiding large rewrites and drift between docs and code.

Core Features & Use Cases

  • PCC refresh and grounding: refreshes PCC before inspection and syncs it after doc changes with the appropriate scope.
  • Focused doc scanning: supports focus filters (user, dev, feature, release, all) and an optional scope path to limit scanning.
  • Minimal, idempotent edits: applies only minimal diffs to existing documents, never restructuring or adding unrelated sections.
  • PR integration & safety: respects git.pr_mode (off/optional/required) and will skip or prompt for PRs accordingly; finalizes iterations by updating bootstrap state.
  • Use Case: update README, docs, changelogs, or plugin SKILL.md files to reflect current PCC facts with minimal disruptive changes.

Quick Start

Run workflow-docs-review with focus=all and scope=. to refresh PCC, apply minimal doc updates, sync PCC, and optionally open a PR.

Frequently Asked Questions about workflow-docs-review

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

FAQPage Schema
How do I update repository documentation to match code changes with minimal diffs?

Documentation updates are applied as minimal, idempotent diffs grounded in the Project Context Cache, avoiding large rewrites and preventing drift between docs and code. It edits existing files only without restructuring or adding unrelated sections.

Can I scan only specific documentation areas like user guides or developer docs?

Yes, focused documentation scanning supports configurable filters for user, dev, feature, release, or all areas. You can also set an optional scope path to limit scanning to targeted repository directories.

Does documentation review automation respect my pull request configuration?

PR integration respects the git.pr_mode setting (off, optional, required) and will skip or prompt for pull requests accordingly. After applying doc changes, it finalizes by updating bootstrap state and syncing the cache.

What is Project Context Cache grounding for documentation maintenance?

PCC grounding refreshes the Project Context Cache before inspecting repository state and syncs it after documentation changes using the appropriate scope. This ensures docs reflect current project facts with minimal disruptive edits.

How do I refresh PCC and apply documentation updates across my entire repository?

Run the review workflow with focus set to all and scope set to the repository root to refresh PCC, apply minimal doc updates, sync PCC, and optionally open a pull request in one pass.

What are the limitations of minimal diff documentation updates?

This approach never restructures existing documents or adds unrelated sections, applying only minimal idempotent edits. Large documentation overhauls or new document creation fall outside its scope.