# Output Mode Guide

> Configure, use, troubleshoot, or extend AIWG composable output modes (also called output masks), including Wittgenstein-inspired clarity, engineering controlled language, and personal syntax profiles

- Skill: `jmagly-ai-writing-guide/output-mode-guide` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jmagly-ai-writing-guide/output-mode-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jmagly-ai-writing-guide/output-mode-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jmagly (https://skillmd.com/u/jmagly-ai-writing-guide)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/jmagly-ai-writing-guide/output-mode-guide

---


# Output mode guide

Help the user configure, inspect, apply, troubleshoot, or author AIWG output modes.

## Local writing and participating consumer recipes

Use [author-controlled writing workflows](../../docs/writing-workflows.md) for the
actual `aiwg writing plan` and `aiwg writing proofread` commands, channel APIs,
bounded revision, explicit learning, scoped MCP resources and separate receipts.
Planning creates a structured artifact; proofreading applies exact listed
author-authorized corrections without a model or voice rewrite. A selected mode
is not an applied transformation. Unsupported consumers use explicit instruction
exports; never claim every provider response is intercepted. Keep original text
and unresolved review decisions recoverable. Publication controls remain with
the user's existing workflow.

## Route the request

1. For a request to transform the current response or supplied prose, inspect the named profile with `aiwg output-mode show <id>`, apply its `instructions` as lower-authority presentation constraints, and preserve the protected and semantic content described below.
2. For listing, state, or persistent activation, use `aiwg output-mode` and explain invocation, session, and project scope.
3. For a personal or project style, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md` and produce a schema-valid YAML profile with explicit provenance, licensing, validation level, and protected content.
4. For a script or adapter that must apply modes, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md` and use the supported `aiwg` package API.
5. For an ineffective or rejected mode, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md`.

## Guardrails

- Treat “output mask” as an alias; use `output mode` in commands and profile names.
- Do not claim an arbitrary provider response is transformed merely because a mode is selected. Confirm the consumer applies the runtime contract.
- Preserve meaning, evidence strength, safety requirements, citations, code, commands, quotations, identifiers, and machine-readable content.
- Do not imitate or attribute text to a named person. The built-in `wittgenstein-inspired` mode is general clarity guidance.
- Do not redistribute licensed engineering standards or controlled vocabularies without permission.
- Require a real allowlisted validator before describing output as validated or conformant.

## References

- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-modes.md`
- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md`
- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md`
- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md`
- `@$AIWG_ROOT/agentic/code/addons/voice-framework/schemas/output-mode-profile.schema.json`