doc-coauthoring
Collaboratively draft, revise, and reader-test substantial documentation such as proposals, RFCs, decision records, technical specifications, strategy documents, and cross-team plans. Use when the user needs help transferring context, shaping an argument, resolving gaps, iterating on an existing document, or validating whether a document works for readers. Use a more specialized document skill when the requested artifact is a product-doc suite, technical tutorial, or API reference.
How do I install this agent skill?
npx skills add https://github.com/full-stack-skills/document-skills --skill doc-coauthoringIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a collaborative document writing assistant. It processes external context and files to draft, refine, and test technical documentation. This functionality presents a surface for indirect prompt injection, where malicious instructions embedded in user-supplied source materials could influence the agent's behavior.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Document Co-Authoring
Act as an active writing partner. Adapt the depth of the workflow to the request instead of forcing the user through a fixed interview.
Route specialized artifacts
- Product documentation suites and PRD hierarchies: hand off to the
full-stack-docskill. Install with:npx skills add full-stack-skills/document-skills --skill full-stack-doc. - Technical tutorials and integration articles: hand off to the
technical-blog-docskill. Install with:npx skills add full-stack-skills/document-skills --skill technical-blog-doc. - API reference generation: hand off to the
api-doc-generatorskill. Install with:npx skills add full-stack-skills/document-skills --skill api-doc-generator.
Use this skill alongside a specialized skill when stakeholder context, argument structure, or reader testing is the main challenge.
Stage 1: Establish the writing contract
Determine from the request and available materials:
- document type and decision it should enable;
- primary and secondary readers;
- desired reader action or understanding;
- required format, length, deadline, and approval constraints;
- source material and authority level;
- target file or shared document, if any.
Ask only questions whose answers materially change the document. Accept shorthand and unstructured context dumps.
Stage 2: Build an evidence map
Separate the input into:
| Category | Treatment |
|---|---|
| Verified fact | State directly and cite or link when useful |
| Decision | Record owner, rationale, and consequences |
| Constraint | Explain its impact on alternatives |
| Assumption | Label explicitly and identify validation needed |
| Open question | Track owner or next action |
| Opinion | Attribute it or turn it into a reasoned recommendation |
Read referenced files or connected sources when available. Do not claim access to integrations or tools that are not present. Never invent absent stakeholder positions.
Stage 3: Propose the structure
Offer an outline appropriate to the document's purpose. Explain only non-obvious ordering choices. For an existing document, preserve its useful structure and propose focused changes rather than replacing it wholesale.
Typical decision-document flow:
- Executive summary
- Context and problem
- Goals and non-goals
- Constraints and evidence
- Options considered
- Recommendation and rationale
- Risks and mitigations
- Rollout, validation, and ownership
- Open questions
Stage 4: Draft and refine
- Draft the highest-value sections first.
- Keep terminology consistent and define ambiguous terms once.
- Prefer concrete claims, examples, and decision criteria over generic prose.
- Preserve the user's voice and requested language.
- Flag evidence gaps inline with
待确认or an equivalent marker. - Track major unresolved decisions separately so they are not buried in prose.
- When editing files, show or summarize material structural changes and never overwrite unrelated content.
Stage 5: Reader testing
Test the document against the actual reader contract:
- Predict questions a new reader will ask.
- Check whether the document answers each question without conversation context.
- Identify ambiguous pronouns, undefined terms, hidden assumptions, unsupported claims, and missing transitions.
- Verify that the requested decision or action is obvious.
- Revise and repeat until no material reader gap remains.
When independent agents are available and the test is safe, give a fresh agent the document and reader questions without leaking the intended answers. Otherwise perform a cold-read pass using only the document text.
Completion contract
Deliver or update the requested artifact, then report:
- the final structure and major decisions;
- unresolved questions and their owners when known;
- evidence that still needs verification;
- reader-test issues found and corrected;
- the exact output location if a file was created.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/full-stack-skills/document-skills/doc-coauthoring">View doc-coauthoring on skillZs</a>