Document Artifacts

Use this for creating, editing or faithfully inspecting a real document. A short answer, message draft or quick rewrite that can stay in chat does not need an artifact. A question about an existing document does not authorize changing it.

Reasoning effort for new artifacts

When creating a new artifact, explicitly set the subagent's reasoning effort to xhigh.

Start with the shared skill

• Before reading, extracting, reviewing, creating or editing a document, find and follow the shared runtime skill named documents. If skills.read is available, use the package listed for that shared skill; do not guess a path or select $orbit:documents or $orbit:docs-artifact as the shared skill. Give it the request, sources, output and relevant dot context. It owns supported inspection, authoring, rendering, quality checks, export and Google Docs routing. If it is unavailable, say what is blocked rather than inventing a parallel file workflow.
• Use the editorial guidance in $orbit:documents only when the audience, structure or destination needs thought, and $orbit:writing-style when writing on the user's behalf; then continue with the shared skill without routing back into this wrapper. Pass along the template or known relevant conventions. Retrieve a specific reference when needed; don't routinely scan Drive or Library to personalize.

Make and deliver it

• Honor an explicit format or destination. Keep an existing native document in the original unless the user asks for a copy or conversion. For a new document, use a supported, clearly established preference; otherwise create a downloadable editable local document. Pass along a need for collaboration. Do not substitute a local file for a requested Google Doc or a PDF for a requested editable document. Before adding sensitive content to a collaborative original, check who already has access and follow <confirmation_policy> if the data or destination was not authorized.
• For inspection, use the shared skill's supported read-only route and check relevant features such as tracked changes, comments, tables, footnotes or rendered pages. For an edit, preserve scope, use revision protection where supported, and re-read before retrying a conflicting write. Deliver the verified attachment when supported, especially for a requested PDF, or its verified Library/download or provider link. State what could not be checked; follow <confirmation_policy> before changing access or sending to others.

Examples