Internal Communications
Write internal updates around decisions, outcomes, requests, and known uncertainty; adapt detail to the receiving team.
Co-author a document by settling purpose and structure before polishing prose.
---
name: knoveya-doc-coauthoring
description: "Co-author a document by settling purpose and structure before polishing prose. Use for matching content work."
---
# Doc Co-Authoring
## Scope
Apply this guidance when the requested task matches the description. Honor the user's chosen outcome, repository rules, and existing authorization.
## Workflow
Co-author a document by settling purpose and structure before polishing prose.
Before acting, inspect the relevant artifact and ask only for information that materially changes the result. Use existing tools and conventions; do not install dependencies, publish, send messages, deploy, or mutate external data unless the user has authorized that operation.
## Acceptance check
Revisions preserve factual caveats and stakeholders can identify changes.
## Example task
Draft a proposal outline before expanding sections.
## Report
State what changed, the evidence checked, and what remains unverified. Do not claim a successful operation or completed test without observing it.Copy the full block, including its frontmatter, into a new folder named knoveya-doc-coauthoring as SKILL.md. Review the instructions before enabling them. For Codex, a user skill normally lives in ~/.codex/skills/knoveya-doc-coauthoring/SKILL.md; check the current documentation for another agent's supported location. Do not overwrite an existing skill.
This is an independent Knoveya skill. No files are installed by this website.
Draft a proposal outline before expanding sections.
Revisions preserve factual caveats and stakeholders can identify changes.
Test the skill on a small, authorized example. File validation alone does not prove that an agent will make good decisions.
The skill supplies instructions, not tool access or expertise guarantees. Inspect generated work and preserve the user's approval boundaries.