Skill Overview

43 workflows contain inline copies of the Report Structure Guidelines (Header Levels, Progressive Disclosure, Report Structure Pattern) that duplicate the content already provided by shared/reporting.md. This creates a maintenance burden: any update to the guidelines requires changes in 43+ places. 30 of these workflows already import shared/reporting.md, making their inline copies completely redundant. The remaining 13 should add the import and remove their inline copies.

Current Usage

Workflows with inline guidelines that ALREADY import shared/reporting.md (redundant, ~30 workflows including):

• agent-performance-analyzer.md
• audit-workflows.md
• auto-triage-issues.md
• breaking-change-checker.md
• ci-coach.md
• daily-code-metrics.md
• daily-compiler-quality.md
• daily-observability-report.md (lines 39–87, ~48 lines)
• daily-performance-summary.md
• daily-team-evolution-insights.md
• daily-team-status.md
• pr-triage-agent.md
• weekly-issue-summary.md
• (and ~17 more)

Workflows with inline guidelines that do NOT import shared/reporting.md (need import added, ~13 workflows including):

• copilot-pr-merged-report.md (gets it transitively via copilot-pr-analysis-base.md)
• copilot-pr-nlp-analysis.md
• copilot-pr-prompt-analysis.md
• deep-report.md
• firewall-escape.md
• portfolio-analyst.md
• repo-audit-analyzer.md
• semantic-function-refactor.md

Proposed Fix

Remove inline guideline sections (typically titled ## 📝 Report Formatting Guidelines or similar) from all 43 workflows and rely solely on shared/reporting.md. Add the import to any missing workflows.

Impact

• Workflows affected: 43 workflows
• Lines saved: ~40–48 lines per workflow × 43 = ~1,700–2,064 lines of redundant content removed
• Maintenance benefit: Guidelines changes only need updating in shared/reporting.md
• Consistency benefit: All workflows will use exactly the same reporting guidelines, not slightly diverged inline copies

Implementation Plan

1. Audit all 43 workflows to identify exact inline sections to remove (search for ## 📝 Report Formatting Guidelines or ### 1. Header Levels patterns)
2. For each workflow already importing shared/reporting.md: remove the inline reporting section
3. For each workflow NOT importing shared/reporting.md: add shared/reporting.md to imports AND remove inline section
4. Run make recompile to regenerate all affected lock files
5. Spot-check 3–5 workflows to confirm guidelines are still present via import

Related Analysis

This recommendation comes from the Workflow Skill Extractor analysis run on 2026-03-01.

Generated by Workflow Skill Extractor

• expires on Mar 3, 2026, 4:19 PM UTC