aops-cli-docman

Manages composable document authoring, publishing, and retrieval through the AOPS CLI docman commands.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/eeemzs/aops --skill aops-cli-docman-eeemzs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aops-cli-docman
Source: https://github.com/eeemzs/aops/tree/main/assets/skills/aops-cli-docman
Command: npx skills add https://github.com/eeemzs/aops --skill aops-cli-docman-eeemzs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing canonical project knowledge as structured, versioned documents is error-prone when agents rebuild whole documents for small edits, publish without guards, or read stale caches. This Skill provides a disciplined playbook for CRUD-first document operations with the AOPS CLI docman domain. ## Core Features & Use Cases - Composable Authoring: Structure documents as sections, pages, and page versions, and make targeted page edits instead of full-document rebuilds. - Guarded Operations: Use baseline-guarded Markdown import, expected-previous-version publish guards, and preview-then-confirm deletion for disposable documents. - Retrieval Gates: After publishing, rebuild index and summary, then verify with search and answer queries before refreshing the local mirror. - Use Case: An agent needs to update one section of an architecture guide: it clones the current version, edits the single page, publishes with version guards, rebuilds the index, verifies a known-fact search reaches the new content, and refreshes the mirror. ## Quick Start Ask the agent to use the aops-cli-docman skill to update one page of a project document and publish it with the AOPS CLI.

Frequently Asked Questions about aops-cli-docman

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

FAQPage Schema
How do I edit a single page of an AOPS document without rebuilding it?▼

Create a new draft version with clone_all init mode, save the page draft with doc page draft-save, publish the page version, then set it current with expected-previous-version guards. This avoids full-document import for targeted changes.

How do I safely delete a document with the AOPS CLI?▼

Run doc delete with the exact document id and confirm-name in preview mode first, then apply with --confirm only after verifying the record. An exact-title mismatch triggers a validation error and prevents deletion.

When should I use doc import instead of page-level edits?▼

Use full Markdown import only when the complete document structure changes, always with a baseline file, guard-target, and dry-run first. For one-page or metadata changes, prefer section and page CRUD commands.

Why does my local docman mirror show stale content after a hosted write?▼

The .aops-cache/docman mirror is a read-only cache that only updates on doc mirror pull. After canonical changes, use remote search and answer first, then refresh the mirror to see current content.

What must I do after publishing a new document version?▼

Rebuild the index and summary, then verify with a known-fact search and a citation-first answer query against the new version. Finally refresh the mirror and confirm it reports the current version id.