Initial commit

SKILL.md

@@ -0,0 +1,117 @@
+---
+name: output-styles-skill
+description: Configure and understand different output formatting styles for Claude Code responses. Provides templates for bullet-points, markdown, YAML, HTML, and specialized formats like TTS summaries and observable tool diffs. Use when you want to control output formatting, need structured data output, or want specialized rendering for specific use cases.
+allowed-tools: Read, Bash
+---
+
+# Output Styles
+
+Configure different output formatting styles to control how Claude Code presents information. This skill provides multiple templates for different communication needs and includes an automatic installation script.
+
+## Prerequisites
+
+- Understanding of your preferred output format
+- Optional: Claude Code with output style configuration support
+- Bash available for running installation script
+
+## Quick Start: Install All Styles
+
+To automatically install all 12 output style templates to your Claude Code configuration:
+
+```bash
+bash ./install-styles.sh
+```
+
+This will copy all styles to `~/.claude/output-styles/` and make them available for use in your Claude Code configuration.
+
+## Available Styles
+
+The output-styles directory contains 12 formatting templates:
+
+1. **bullet-points.md** - Concise bullet-point format
+2. **markdown-focused.md** - Clean markdown with emphasis on structure
+3. **yaml-structured.md** - YAML-formatted structured output
+4. **table-based.md** - Table-formatted presentation
+5. **html-structured.md** - HTML-structured output
+6. **ultra-concise.md** - Minimal, ultra-condensed format
+7. **genui.md** - UI-friendly generation format
+8. **tts-summary-base.md** - Base TTS (text-to-speech) summary format
+9. **tts-summary.md** - Enhanced TTS summary format
+10. **tts-summary-base-diffs.md** - TTS format with code diffs
+11. **observable-tools-diffs.md** - Observable tool integration with diffs
+12. **observable-tools-diffs-tts.md** - Observable tools with TTS and diffs
+
+## Workflow
+
+1. **Identify need** - Determine what output format best suits your use case
+2. **Review template** - Read the appropriate style template
+3. **Apply format** - Use the template to structure responses
+4. **Validate** - Ensure output matches the template structure
+
+## Installation & Setup
+
+### Step 1: Install Styles to Your System
+
+Run the installation script to copy all style templates:
+
+```bash
+bash ./install-styles.sh
+```
+
+**What it does:**
+- Creates `~/.claude/output-styles/` directory if needed
+- Copies all 12 style templates from the plugin
+- Confirms installation with a list of installed styles
+
+### Step 2: Reference Styles in Configuration
+
+After installation, you can reference these styles in:
+- Claude Code hooks (in `.claude/hooks/`)
+- Claude Code settings (`.claude/settings.json`)
+- Custom commands and workflows
+
+## Using Output Styles
+
+### Best Use Cases
+
+- **For reports/documentation** → Use `markdown-focused.md`
+- **For structured data** → Use `yaml-structured.md` or `table-based.md`
+- **For concise updates** → Use `bullet-points.md` or `ultra-concise.md`
+- **For accessibility** → Use `tts-summary.md`
+- **For tool integration** → Use `observable-tools-diffs.md`
+
+### Applying Styles in Hooks
+
+Styles are typically applied via hooks. Reference them in your hook configuration:
+
+```json
+{
+  "event": "output",
+  "command": "apply-style",
+  "style": "~/.claude/output-styles/bullet-points.md"
+}
+```
+
+### Viewing Available Styles
+
+After installation, list available styles:
+
+```bash
+ls -1 ~/.claude/output-styles/
+```
+
+## Examples
+
+**Example 1: Getting bullet-point summaries**
+```
+User: Use the bullet-points style for all future responses
+Claude: [Configures output style]
+All subsequent responses use condensed bullet-point format
+```
+
+**Example 2: Using structured YAML output**
+```
+User: Show results in YAML format
+Claude: [Applies yaml-structured style]
+Response output matches YAML template structure
+```