Table of Contents
Structured Output
When To Use
- When finalizing any review or analysis.
- To format findings in a consistent and actionable way.
- Before presenting results to stakeholders or committing them to documentation.
When NOT To Use
- Capturing evidence during analysis - use proof-of-work
- Reviewing changes - use diff-analysis or review-core first
Activation Patterns
Trigger Keywords: format, structure, deliverable, report, organize, present, consistent
Contextual Cues:
- "format this as a report" or "structure the output"
- "create a deliverable" or "present these findings"
- "organize this consistently" or "standardize the format"
- "make this actionable" or "prepare for stakeholders"
Auto-Load When: Finalizing any analysis deliverable or when consistent formatting is requested.
Required TodoWrite Items
structured-output:template-selected
structured-output:findings-formatted
structured-output:actions-assigned
structured-output:appendix-attached
Mark each item complete as you finish the corresponding step.
Step 1: Select Template (structured-output:template-selected)
- Choose output format based on deliverable type:
- Review Report: Summary, Findings, Recommendations, Evidence.
- PR Description: Summary, Changes, Test Plan, Notes.
- Release Notes: Highlights, Breaking Changes, Fixes, Credits.
- Incident Report: Timeline, Impact, Root Cause, Remediation.
- Confirm audience and required detail level.
Step 2: Format Findings (structured-output:findings-formatted)
Step 3: Assign Actions (structured-output:actions-assigned)
- Convert findings to actionable items:
## Action Items
- [ ] [HIGH] Fix SQL injection in auth.py:45 (@security-team, P1)
- [ ] [MEDIUM] Add input validation to API endpoint (@backend, P2)
- [ ] [LOW] Update deprecated dependency (@devops, P3)
Verification: Run the command with --help flag to verify availability.
- Include owner assignment where known.
- Add priority indicators (P1/P2/P3) for triage.
- Note dependencies between actions.
Step 4: Attach Appendix (structured-output:appendix-attached)
- Compile supporting materials:
## Appendix
### A. Commands Run
[Full evidence log from imbue:proof-of-work]
### B. External References
[Citations and documentation links]
### C. Raw Data
[Large outputs, full diffs, or data exports]
Verification: Run the command with --help flag to verify availability.
- Keep main report concise; details in appendix.
- validate appendix is navigable with clear section headers.
Output Quality Checklist
Before finalizing:
Exit Criteria
- Todos completed with formatted deliverable.
- Output follows selected template structure.
- Stakeholders can act on findings without clarification.
Troubleshooting
Common Issues
Command not found
Ensure all dependencies are installed and in PATH
Permission errors
Check file permissions and run with appropriate privileges
Unexpected behavior
Enable verbose logging with --verbose flag
1---2name: structured-output3description: 'Consult this skill when formatting final review deliverables. Use when4 formatting final review outputs, ensuring consistent deliverable structure, making5 findings comparable across reviews. Do not use when capturing evidence during analysis6 - use proof-of-work. DO NOT use when: reviewing changes - use diff-analysis or7 review-core first.'8category: output-patterns9tags:10- formatting11- deliverables12- consistency13- reporting14- structure15dependencies:16- imbue:proof-of-work17tools: []18usage_patterns:19- deliverable-formatting20- report-structure21- consistent-output22complexity: beginner23estimated_tokens: 100024metadata:25 source: https://skillmd.com/skills/micsapp/structured-output26---2728## Table of Contents2930- [When to Use](#when-to-use)31- [Activation Patterns](#activation-patterns)32- [Required TodoWrite Items](#required-todowrite-items)33- [Step 1: Select Template (`structured-output:template-selected`)](#step-1:-select-template-(structured-output:template-selected))34- [Step 2: Format Findings (`structured-output:findings-formatted`)](#step-2:-format-findings-(structured-output:findings-formatted))35- [Step 3: Assign Actions (`structured-output:actions-assigned`)](#step-3:-assign-actions-(structured-output:actions-assigned))36- [Step 4: Attach Appendix (`structured-output:appendix-attached`)](#step-4:-attach-appendix-(structured-output:appendix-attached))37- [Output Quality Checklist](#output-quality-checklist)38- [Exit Criteria](#exit-criteria)394041# Structured Output4243## When To Use44- When finalizing any review or analysis.45- To format findings in a consistent and actionable way.46- Before presenting results to stakeholders or committing them to documentation.4748## When NOT To Use4950- Capturing evidence during analysis - use proof-of-work51- Reviewing changes - use diff-analysis or review-core first5253## Activation Patterns54**Trigger Keywords**: format, structure, deliverable, report, organize, present, consistent55**Contextual Cues**:56- "format this as a report" or "structure the output"57- "create a deliverable" or "present these findings"58- "organize this consistently" or "standardize the format"59- "make this actionable" or "prepare for stakeholders"6061**Auto-Load When**: Finalizing any analysis deliverable or when consistent formatting is requested.6263## Required TodoWrite Items641. `structured-output:template-selected`652. `structured-output:findings-formatted`663. `structured-output:actions-assigned`674. `structured-output:appendix-attached`6869Mark each item complete as you finish the corresponding step.7071## Step 1: Select Template (`structured-output:template-selected`)72- Choose output format based on deliverable type:73 - **Review Report**: Summary, Findings, Recommendations, Evidence.74 - **PR Description**: Summary, Changes, Test Plan, Notes.75 - **Release Notes**: Highlights, Breaking Changes, Fixes, Credits.76 - **Incident Report**: Timeline, Impact, Root Cause, Remediation.77- Confirm audience and required detail level.7879## Step 2: Format Findings (`structured-output:findings-formatted`)80- Use consistent finding structure:81 ```markdown82 ### [SEVERITY] Finding Title83 **Location**: file.rs:12384 **Category**: Security | Performance | Correctness | Style85 **Description**: Brief explanation of the issue.86 **Evidence**: [E1, E2] - Reference to evidence log.87 **Recommendation**: Specific remediation steps.88 ```89 **Verification:** Run the command with `--help` flag to verify availability.90- Severity levels: CRITICAL, HIGH, MEDIUM, LOW, INFO.91- Order findings by severity, then by file location.9293## Step 3: Assign Actions (`structured-output:actions-assigned`)94- Convert findings to actionable items:95 ```markdown96 ## Action Items97 - [ ] [HIGH] Fix SQL injection in auth.py:45 (@security-team, P1)98 - [ ] [MEDIUM] Add input validation to API endpoint (@backend, P2)99 - [ ] [LOW] Update deprecated dependency (@devops, P3)100 ```101 **Verification:** Run the command with `--help` flag to verify availability.102- Include owner assignment where known.103- Add priority indicators (P1/P2/P3) for triage.104- Note dependencies between actions.105106## Step 4: Attach Appendix (`structured-output:appendix-attached`)107- Compile supporting materials:108 ```markdown109 ## Appendix110 ### A. Commands Run111 [Full evidence log from imbue:proof-of-work]112113 ### B. External References114 [Citations and documentation links]115116 ### C. Raw Data117 [Large outputs, full diffs, or data exports]118 ```119 **Verification:** Run the command with `--help` flag to verify availability.120- Keep main report concise; details in appendix.121- validate appendix is navigable with clear section headers.122123## Output Quality Checklist124Before finalizing:125- [ ] All findings have evidence references.126- [ ] Severity levels are justified.127- [ ] Recommendations are specific and actionable.128- [ ] No orphaned sections or placeholder text.129- [ ] Format renders correctly in target medium (GitHub, Confluence, etc.).130131## Exit Criteria132- Todos completed with formatted deliverable.133- Output follows selected template structure.134- Stakeholders can act on findings without clarification.135## Troubleshooting136137### Common Issues138139**Command not found**140Ensure all dependencies are installed and in PATH141142**Permission errors**143Check file permissions and run with appropriate privileges144145**Unexpected behavior**146Enable verbose logging with `--verbose` flag